{
  "markdown": "# claude-auto-setup\n\n`claude-auto-setup` is shipped as package + claude skill.\n\nOne prompt more. That's all it costs to have Claude Code search the web, find the right skills, MCPs, hooks, and agents for your task, configure everything automatically, and put your work in an isolated environment you can resume, share, or discard cleanly.\n\n `claude-auto-setup` enables the creation of the best set of skills completely automatically without the need of manual setup and project engineering: those steps are crucial for a big project or enterprise repo but most of the times with the smaller tasks none of this is worht to be setted up. The package is seamlessy integrated with the skill and enable the creation of a whole set of configs, that can be coupled with one or more claude chats and remains completely isolated thanks to a dedicated worktree.\n\n---\n\n## 🚀 Installation\n\n> Requires: Claude Code • Node.js 20+\n\n```bash\nnpm install -g claude-auto-setup\n# or: yarn global add claude-auto-setup\n# or: pnpm add -g claude-auto-setup\n```\n\nThe install automatically copies the skill to `~/.claude/skills/` so it's available in every project.\n\n---\n\n## ⚡ Quick start\n\n```bash\n# 1. Register a session\nclaudesetup \"build a production Elixir Phoenix backend for DICOM medical image processing\"\n\n# 2. Open Claude Code in the isolated worktree\nclaude --worktree elixir-phoenix-dicom\n\n# 3. Trigger the skill inside Claude Code\n/claude-auto-setup\n# or use a phrase: \"setup claude for...\", \"configure session for...\", \"I need a setup for...\"\n\n# Claude searches GitHub and community registries, shows you a plan, you confirm, it installs everything.\n\n# 4. Work normally — all edits stay on the worktree branch, never touching main\n\n# 5. Export only your code when done\nclaudesetup export <session-id>\n```\n\n> **Note:** Typing `\"build X\"` alone will NOT trigger the skill — Claude will just start building.\n> Use `/claude-auto-setup` or a `\"setup claude for...\"` phrase to invoke it explicitly.\n\n---\n\n## 🎯 What it does\n\n```\nBefore: Need a dbt pipeline setup → Find skills manually, read docs, configure MCPs, write hooks, repeat\nAfter:  One prompt → Claude searches live, shows plan, you confirm → everything installed in 2 minutes\n\nBefore: Setup files mixed into your project → .claude/ config committed to main, hard to clean up\nAfter:  Worktree isolation → setup lives on its own branch, export strips it automatically\n\nBefore: Close Claude → lose context, have to reconfigure next session\nAfter:  claudesetup resume → picks up the exact session, verifies config, drops you back in\n```\n\n---\n\n## 🧠 How it works\n\nThe `SKILL.md` installed in `~/.claude/skills/claude-auto-setup/` is the brain. When triggered, it guides Claude through 7 phases — all in a single session, optimized for minimal token usage:\n\n1. **Idempotency check** — skips setup if already configured for this task\n2. **Understand intent** — extracts tech stack, keywords, session name from your description\n3. **Search** — one parallel pass using Claude's native `WebSearch` and `WebFetch`: GitHub, awesome-claude-code, awesome-mcp-servers, the official plugin marketplace. All in a single turn.\n4. **Plan** — builds a `SessionPlan` from results and displays it before touching anything\n5. **Confirm** — mandatory gate; edit individual items or abort\n6. **Execute** — writes SKILL.md files, installs MCPs via `claude mcp add`, merges hooks into `settings.json`, writes agent files. Falls back to generating a skill from scratch when nothing suitable is found.\n7. **Summarize** — prints exactly what was installed, how to use each tool, and your session commands\n\nThe CLI handles what the skill can't do from inside a session: registering sessions, persisting the lock file across Claude exits, managing the worktree lifecycle, and producing a setup-aware diff on export.\n\n---\n\n## 🌿 Worktree isolation\n\nEvery session lives in its own git worktree — a real branch with an independent working directory. Your main branch is never touched.\n\n```bash\nclaudesetup export my-session\n# → 12 source files changed, 0 config files included\n# → [m]erge / [s]quash / [c]ancel\n```\n\nThe session lock records every file written during configuration. `export` uses that list to build the exclusion — so `.claude/` setup files are filtered out automatically, not by guesswork.\n\n---\n\n## 📦 Session commands\n\n```bash\nclaudesetup list                    # all sessions with status\nclaudesetup status <session-id>     # full session details\nclaudesetup resume <session-id>     # resume (recreates worktree if needed, checks for drift)\nclaudesetup export <session-id>     # export code only, setup excluded\nclaudesetup erase <session-id>      # delete files, restore settings, remove worktree\n```\n\n---\n\n## 📋 CLI reference\n\n```bash\nclaudesetup \"intent\"                # create session (shorthand)\nclaudesetup setup \"intent\"          # same, explicit subcommand\nclaudesetup list\nclaudesetup status <id>\nclaudesetup resume <id>\nclaudesetup export <id>\nclaudesetup erase <id>\n```\n\nBoth `claudesetup` and `claude-auto-setup` work as binary names.\n\n---\n\n## ❓ Getting help\n\n```bash\nclaudesetup doctor                  # check installation and session state\n```\n\n**Skill not triggering?**\nUse `/claude-auto-setup` explicitly rather than a phrase — slash commands are always reliable.\n\n**Worktree missing after resume?**\n`claudesetup resume` recreates it automatically from the lock file if the branch still exists.\n\n**MCP not working after resume?**\nRun `claudesetup status <id>` to see what was installed, then re-run `claude mcp add` for the specific server.\n\n---\n\n> Not affiliated with Anthropic. Claude and Claude Code are trademarks of Anthropic.\n\n## License\n\nMIT\n",
  "bytes": 5695,
  "sha": "66af708ebf91b303c752c09295bdf98c549d4c40c9fa7615a43201a72f210d42",
  "repo_slug": "patalanostefano/claudeautosetup",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_patalanostefano_claudeautosetup_claude_a_8709ec2c/readme"
}