{"id":44899267,"url":"https://github.com/agoldian/claudenv","last_synced_at":"2026-04-01T19:37:34.744Z","repository":{"id":338828219,"uuid":"1159312245","full_name":"AGoldian/claudenv","owner":"AGoldian","description":"Automated project documentation generator for Claude Code and AI coding agents. Scans any tech stack, asks clarifying questions, generates CLAUDE.md + memory files + validation hooks. Dual-mode: slash commands inside Claude Code + standalone npm CLI.","archived":false,"fork":false,"pushed_at":"2026-02-17T21:37:19.000Z","size":93,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-19T00:29:28.258Z","etag":null,"topics":["ai-agents","antropic","claude","claude-code","devtools"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/claudenv","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AGoldian.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-16T15:24:55.000Z","updated_at":"2026-02-18T03:17:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AGoldian/claudenv","commit_stats":null,"previous_names":["agoldian/claudenv"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/AGoldian/claudenv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGoldian%2Fclaudenv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGoldian%2Fclaudenv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGoldian%2Fclaudenv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGoldian%2Fclaudenv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AGoldian","download_url":"https://codeload.github.com/AGoldian/claudenv/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGoldian%2Fclaudenv/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29636035,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T22:32:43.237Z","status":"ssl_error","status_checked_at":"2026-02-19T22:32:38.330Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","antropic","claude","claude-code","devtools"],"created_at":"2026-02-17T21:06:11.916Z","updated_at":"2026-04-01T19:37:34.732Z","avatar_url":"https://github.com/AGoldian.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claudenv\n\nSet up [Claude Code](https://docs.anthropic.com/en/docs/claude-code) in any project with one command. claudenv analyzes your codebase and generates everything Claude needs to work effectively — documentation, rules, hooks, MCP servers, and slash commands.\n\n## Quick Start\n\n```bash\nnpm i -g claudenv \u0026\u0026 claudenv\n```\n\nOpen Claude Code in any project and type `/claudenv`. That's it.\n\n## What happens when you run `/claudenv`\n\nClaude reads your code, asks a few questions, and generates:\n\n- **CLAUDE.md** — project overview, architecture, key commands\n- **Rules** — coding style, testing patterns, workflow guidelines (`.claude/rules/`)\n- **MCP servers** — auto-detected from your stack, configured in `.mcp.json`\n- **Slash commands** — `/init-docs`, `/update-docs`, `/validate-docs`, `/setup-mcp`, `/improve`\n- **Hooks** — validation on tool use, audit logging (`.claude/settings.json`)\n\nEverything is committed to your repo. Team members get the same Claude experience.\n\n## Autonomous Loop\n\nThe killer feature. `claudenv loop` runs Claude in headless mode, iterating over your project — planning improvements, implementing them one by one, committing each step.\n\n```bash\nclaudenv loop --goal \"add test coverage\" --trust -n 5\n```\n\n**What it does:**\n\n1. Creates a git safety tag (rollback anytime with `--rollback`)\n2. Claude generates an improvement plan (`.claude/improvement-plan.md`)\n3. Each iteration picks the next item, implements it, runs tests, commits\n4. Stops when the plan is done, iterations run out, or it detects it's stuck\n\n### Common recipes\n\n```bash\n# Interactive mode — pauses between iterations so you can review\nclaudenv loop\n\n# Fully autonomous — no pauses, no permission prompts\nclaudenv loop --trust\n\n# Goal-driven with Opus for max capability\nclaudenv loop --goal \"refactor auth to JWT\" --trust --model opus -n 3\n\n# Budget-conscious CI run\nclaudenv loop --profile ci --goal \"fix lint errors\" -n 10\n\n# Undo everything from the last loop\nclaudenv loop --rollback\n```\n\n### Rate limit recovery\n\nIf Claude hits API rate limits mid-loop, claudenv saves your progress automatically:\n\n```bash\n# Rate limited? Just resume where you left off\nclaudenv loop --resume\n\n# Override model on resume (e.g., switch to cheaper model)\nclaudenv loop --resume --model sonnet\n```\n\n### Live progress tracking\n\nMonitor what Claude is doing in real time:\n\n```bash\n# In another terminal — tail -f style\nclaudenv report --follow\n\n# Summary of the last loop run\nclaudenv report\n\n# Last 5 events only\nclaudenv report --last 5\n```\n\nEvents are stored in `.claude/work-report.jsonl` — machine-readable JSONL format.\n\n### All loop flags\n\n| Flag | Description |\n|------|-------------|\n| `--goal \u003ctext\u003e` | What to work on (any goal — Claude interprets it) |\n| `--trust` | Full trust mode — no pauses, skip permission prompts |\n| `-n, --iterations \u003cn\u003e` | Max iterations (default: unlimited) |\n| `--model \u003cmodel\u003e` | Model: `opus`, `sonnet`, `haiku` |\n| `--profile \u003cname\u003e` | Autonomy profile (sets model, trust, budget) |\n| `--budget \u003cusd\u003e` | Budget cap per iteration in USD |\n| `--max-turns \u003cn\u003e` | Max agentic turns per iteration (default: 30) |\n| `--resume` | Continue from last rate-limited loop |\n| `--rollback` | Undo all changes from the most recent loop |\n| `--worktree` | Run each iteration in an isolated git worktree |\n| `--allow-dirty` | Allow running with uncommitted changes |\n| `--no-pause` | Don't pause between iterations |\n| `--unsafe` | Remove default tool restrictions (allows rm -rf) |\n| `-d, --dir \u003cpath\u003e` | Target project directory |\n\n## Autonomy Profiles\n\nControl how much freedom Claude gets. Profiles configure permissions, hooks, model defaults, and safety guardrails.\n\n```bash\nclaudenv autonomy                          # Interactive selection\nclaudenv autonomy --profile moderate       # Apply directly\nclaudenv autonomy --profile ci --dry-run   # Preview without writing\n```\n\n### Profile comparison\n\n| Profile | Model | Permissions | Credentials | Use case |\n|---------|-------|-------------|-------------|----------|\n| **safe** | sonnet | Allow-list only (read + limited bash) | Blocked | Exploring unfamiliar codebases |\n| **moderate** | sonnet | Allow + deny lists (full dev tools) | Blocked | Day-to-day development |\n| **full** | opus | Unrestricted (`--dangerously-skip-permissions`) | Warn-only | Maximum capability runs |\n| **ci** | haiku | Unrestricted + 50 turn / $5 budget limits | Warn-only | CI/CD pipelines |\n\nAll profiles hard-block `rm -rf`, force push to main/master, and `sudo` — regardless of permission settings.\n\n### What gets generated\n\n```\n.claude/\n├── settings.json          # Permissions, hooks config\n├── hooks/\n│   ├── pre-tool-use.sh    # Blocks dangerous operations (reads stdin JSON from Claude Code)\n│   └── audit-log.sh       # Logs every tool call to audit-log.jsonl\n└── aliases.sh             # Shell aliases: claude-safe, claude-yolo, claude-ci, claude-local\n```\n\nCI profile also generates `.github/workflows/claude-ci.yml`.\n\n### Using profiles with the loop\n\nProfiles set sensible defaults for model, trust, and budget:\n\n```bash\nclaudenv loop --profile ci --goal \"fix lint errors\"    # haiku, $5 budget, 50 turns\nclaudenv loop --profile full --goal \"major refactor\"   # opus, unrestricted\nclaudenv loop --profile moderate --goal \"add types\"    # sonnet, deny-list guarded\n\n# CLI flags always override profile defaults\nclaudenv loop --profile ci --model sonnet              # ci profile but with sonnet\n```\n\n## MCP Server Setup\n\n`/claudenv` auto-detects your tech stack and recommends MCP servers from the [official registry](https://registry.modelcontextprotocol.io). You can also run `/setup-mcp` independently.\n\nServers are configured in `.mcp.json` with `${ENV_VAR}` placeholders — safe to commit:\n\n```json\n{\n  \"mcpServers\": {\n    \"context7\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@upstash/context7-mcp@latest\"]\n    },\n    \"postgres\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-postgres@latest\", \"${POSTGRES_CONNECTION_STRING}\"]\n    }\n  }\n}\n```\n\nSet secrets with `claude config set env.POSTGRES_CONNECTION_STRING \"postgresql://...\"`.\n\n## File Structure\n\nAfter full setup (`/claudenv` + `claudenv autonomy`):\n\n```\nyour-project/\n├── CLAUDE.md                     # Project overview for Claude\n├── _state.md                     # Session memory (persists between conversations)\n├── .mcp.json                     # MCP server configuration\n└── .claude/\n    ├── settings.json             # Permissions + hooks\n    ├── rules/\n    │   ├── code-style.md         # Coding conventions\n    │   ├── testing.md            # Test patterns\n    │   └── workflow.md           # Claude workflow best practices\n    ├── hooks/\n    │   ├── pre-tool-use.sh       # Safety guardrails\n    │   └── audit-log.sh          # Audit logging\n    ├── commands/                  # Slash commands\n    │   ├── init-docs.md\n    │   ├── update-docs.md\n    │   ├── validate-docs.md\n    │   ├── setup-mcp.md\n    │   └── improve.md\n    ├── aliases.sh                # Shell aliases\n    ├── work-report.jsonl         # Loop progress events\n    ├── loop-log.json             # Loop state (for resume/rollback)\n    ├── improvement-plan.md       # Current loop plan\n    └── audit-log.jsonl           # Tool call audit trail\n```\n\n## CLI Reference\n\n```\nclaudenv                              Install /claudenv into ~/.claude/\nclaudenv install [-f]                 Same as above (-f to overwrite)\nclaudenv uninstall                    Remove from ~/.claude/\n\nclaudenv loop [options]               Autonomous improvement loop\nclaudenv loop --resume                Resume rate-limited loop\nclaudenv loop --rollback              Undo all loop changes\nclaudenv report [--follow] [--last n] View loop progress\n\nclaudenv autonomy [-p \u003cprofile\u003e]      Configure autonomy profiles\nclaudenv init [dir] [-y]              Legacy: static analysis (no AI)\nclaudenv generate [-d \u003cdir\u003e]          Templates only, no scaffold\nclaudenv validate [-d \u003cdir\u003e]          Check documentation completeness\n```\n\n## Run Without Installing\n\n```bash\nnpx claudenv            # npm\npnpm dlx claudenv       # pnpm\nbunx claudenv           # bun\n```\n\n## Tech Stack Detection\n\nAuto-detected for context: TypeScript, JavaScript, Python, Go, Rust, Ruby, PHP, Java, Kotlin, C# / Next.js, Vite, Nuxt, SvelteKit, Astro, Django, FastAPI, Flask, Rails, Laravel, Spring Boot / npm, yarn, pnpm, bun, poetry, uv, cargo / Vitest, Jest, Playwright, pytest, RSpec / GitHub Actions, GitLab CI / ESLint, Biome, Prettier, Ruff, Clippy.\n\n## Requirements\n\n- Node.js \u003e= 20\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagoldian%2Fclaudenv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagoldian%2Fclaudenv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagoldian%2Fclaudenv/lists"}