Teleport Init

Teleport Init

Set up Teleport for the first time on this machine.

Steps

1. Check prerequisites: Run node "${CLAUDE_PLUGIN_ROOT}/dist/cli.js" context. Parse the JSON result.

• If auth.ghInstalled is false: show install command based on auth.os (darwin: brew install gh, linux: sudo apt install gh). STOP.
• If auth.authenticated is false: show gh auth login instructions. STOP.
• Store auth.username and machine.alias.

1. Confirm machine name: Show the detected machine.alias to the user. Ask if they want to keep it or rename. If an argument was provided, use that instead.

1. Create hub repo: Run node "${CLAUDE_PLUGIN_ROOT}/dist/cli.js" hub-init --clone-to /tmp/claude-teleport-hub. Parse result.

• If created is false: inform user "Hub already exists at . Using existing."
• If created is true: inform user "Created private hub at ."
• Store username and localPath from the result for later use.

1. Scan local environment: Run node "${CLAUDE_PLUGIN_ROOT}/dist/cli.js" scan --claude-dir ~/.claude --output /tmp/teleport-scan.json. Parse the JSON output — it contains a summary object with counts per category.

1. Present summary: Using the summary from the scan output, present:

``` Found on this machine:

• Plugins: {summary.plugins}
• Agents: {summary.agents}
• Rules: {summary.rules}
• Skills: {summary.skills}
• Hooks: {summary.hooks}
• Settings keys: {summary.settings}
• MCP configs: {summary.mcp}

```

1. Category selection: Use AskUserQuestion with multiSelect: true to present categories (Plugins, Agents, Rules, Skills, Hooks, Settings — only show categories with items). Then for each selected category, use another AskUserQuestion with multiSelect: true listing the individual items, asking "Any items to exclude?"

Important: In the snapshot JSON, most categories (agents, rules, skills, commands, mcp) are arrays of FileEntry objects with a relativePath field. However, settings is a plain object (key-value pairs, not an array) — use Object.keys() to list its items. plugins and marketplaces are arrays of objects with a name field. hooks is an array of objects with name and event fields.

1. Secret scan: Run node "${CLAUDE_PLUGIN_ROOT}/dist/cli.js" secret-scan --snapshot-file /tmp/teleport-scan.json --output /tmp/teleport-secrets.json. Read findings. If any: show each finding with file and line. Confirm exclusion.

1. First-push review gate: "This is the first push. Please review the files that will be committed:" Show the file list. Wait for user confirmation.

1. Push to hub: Write selections to /tmp/teleport-selections.json. Run node "${CLAUDE_PLUGIN_ROOT}/dist/cli.js" hub-push --hub-path --machine --username --snapshot-file /tmp/teleport-scan.json --selections-file /tmp/teleport-selections.json. This writes configs under machines// in the hub, generates registry.yaml on main, and creates an agent-friendly README.md.

1. Success: Show "Your Claude Code setup has been teleported to . Run /teleport-pull on other machines to apply."

1. Cleanup: Remove temp files.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: seilk
• Source: seilk/claude-teleport
• License: MIT

Install and usage instructions live in the source repository linked above.