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.

2. 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.

3. 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.

4. 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.

5. 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}
   

6. 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.