{"id":46265890,"url":"https://github.com/brabos-ai/code-addiction","last_synced_at":"2026-06-14T05:01:35.229Z","repository":{"id":341845193,"uuid":"1170815783","full_name":"brabos-ai/code-addiction","owner":"brabos-ai","description":"📋 The Spec-Driven Development framework. Define the what, AI handles the how.","archived":false,"fork":false,"pushed_at":"2026-05-22T01:35:32.000Z","size":2383,"stargazers_count":8,"open_issues_count":8,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-22T08:52:45.130Z","etag":null,"topics":["ai-coding","claude-code","codex","copilot","developer-tools","engineering","framework","productivity","spec","spec-driven-development"],"latest_commit_sha":null,"homepage":"","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/brabos-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","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-03-02T14:55:04.000Z","updated_at":"2026-05-22T01:01:26.000Z","dependencies_parsed_at":"2026-03-09T06:02:58.933Z","dependency_job_id":null,"html_url":"https://github.com/brabos-ai/code-addiction","commit_stats":null,"previous_names":["brabos-ai/code-addiction"],"tags_count":57,"template":true,"template_full_name":null,"purl":"pkg:github/brabos-ai/code-addiction","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brabos-ai%2Fcode-addiction","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brabos-ai%2Fcode-addiction/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brabos-ai%2Fcode-addiction/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brabos-ai%2Fcode-addiction/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brabos-ai","download_url":"https://codeload.github.com/brabos-ai/code-addiction/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brabos-ai%2Fcode-addiction/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34309655,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-coding","claude-code","codex","copilot","developer-tools","engineering","framework","productivity","spec","spec-driven-development"],"created_at":"2026-03-04T02:11:40.812Z","updated_at":"2026-06-14T05:01:35.223Z","avatar_url":"https://github.com/brabos-ai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Code Addiction (ADD)\n \n[![CI](https://github.com/brabos-ai/code-addiction/actions/workflows/ci.yml/badge.svg)](https://github.com/brabos-ai/code-addiction/actions/workflows/ci.yml)\n[![npm version](https://img.shields.io/npm/v/codeadd.svg)](https://www.npmjs.com/package/codeadd)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\nAI-powered development workflows that make you addicted to shipping code. Production-ready commands, scripts, and skills for AI coding assistants, with a single CLI installer.\n\n**Official Framework Site**: [code.brabos.ai](https://code.brabos.ai) — your complete development workflow guide and documentation.\n\n## Why this project exists\n\nMost AI coding setups are fragmented across custom prompts, scripts, and editor-specific conventions.\n\nCode Addiction standardizes this with:\n- A shared core in `.codeadd/` (commands, scripts, skills, templates)\n- Provider-specific integrations (Claude, Codex, Antigravity, KiloCode, OpenCode)\n- A versioned installer (`codeadd`) with `install`, `update`, `uninstall`, `doctor`, and `validate`\n\n## Quickstart\n\n```bash\n# install latest release\nnpx codeadd install\n\n# install a specific version (e.g., v0.2.20)\nnpx codeadd install --version v0.2.20\n\n# check environment health\nnpx codeadd doctor\n\n# validate file integrity via SHA-256 hashes\nnpx codeadd validate\n\n# repair missing or corrupted files\nnpx codeadd validate --repair\n\n# update to latest release\nnpx codeadd update\n\n# update to a specific version\nnpx codeadd update --version v0.2.14\n\n# remove Code Addiction files from your project\nnpx codeadd uninstall\n\n# list optional features\nnpx codeadd features list\n\n# list available plugins\nnpx codeadd plugins list\n\n# enable a plugin (e.g., gitnexus)\nnpx codeadd plugins enable gitnexus\n\n# disable a plugin\nnpx codeadd plugins disable gitnexus\n\n# show installation configuration\nnpx codeadd config show\n```\n\n## How it works\n\nCode Addiction turns complex development into a guided, repeatable flow. Instead of figuring out *how* to build, you just follow the next command. The AI does the heavy lifting — you stay in control.\n\n### The Development Trail\n\nEvery feature follows a clear path from idea to delivery. Pick the trail that fits your task:\n\n```\nStep        Command             What happens                        Output\n───────────────────────────────────────────────────────────────────────────────\n0. Explore  /add.brainstorm     Brainstorm ideas (read-only)        Initial concept\n1. Discover /add.new            AI-guided feature discovery          about.md\n2. Design   /add.design         UX spec, mobile-first               UI/UX specification\n3. Plan     /add.plan           Technical planning + checklist       plan.md\n4. Code     /add.build          Subagent-driven implementation       Working code\n5. Review   /add.review          Automated code review + validation   Quality gate\n6. Done     /add.done           Changelog, docs, finalization        Ready to merge\n```\n\n### Choose your flow\n\nPick the shortest path that fits. Less ceremony, same quality.\n\n```\nCOMPLETE  (complex features with UI)\n  brainstorm --\u003e new --\u003e design --\u003e plan --\u003e build --\u003e review --\u003e done\n\nSTANDARD  (features without complex UI)\n  new --\u003e plan --\u003e build --\u003e review --\u003e done\n\nLEAN      (small changes, quick tasks)\n  new --\u003e build --\u003e done\n\nAUTONOMOUS  (full AI implementation, no interaction)\n  new --\u003e autopilot --\u003e done\n\nEXPLORATION  (don't know where to start?)\n  brainstorm --\u003e new --\u003e ...pick your flow above\n\nEMERGENCY  (critical bug in production)\n  hotfix --\u003e done\n\nTRIAGE  (ambiguous symptoms, unclear path)\n  diagnose --\u003e (hotfix OR new OR no-action)\n\nNEW PROJECT  (starting from scratch)\n  init --\u003e build --\u003e done\n\nANALYSIS  (understand existing codebase)\n  xray / audit\n```\n\n\u003e **That's it.** No config files to tweak, no boilerplate to write, no decision fatigue.\n\u003e Type the command, follow the AI, ship the feature. Repeat.\n\n### Why teams get addicted\n\n- **Zero ramp-up** — new devs ship on day one by following the flow\n- **10x fewer decisions** — the framework already made the boring ones for you\n- **Consistent output** — every feature gets discovery, planning, review, and docs automatically\n- **Works with your stack** — NestJS, React, any database, any provider\n\n## What gets installed\n\n- Core: `.codeadd/`\n- Optional providers:\n  - Claude Code -\u003e `.claude/`\n  - Codex (OpenAI) -\u003e `.agents/`\n  - Google Antigravity -\u003e `.agent/`\n  - KiloCode -\u003e `.kilocode/`\n  - OpenCode -\u003e `.opencode/`\n\n## Repository structure\n\n- `cli/`: installer CLI published as `codeadd`\n- `framework/`: framework payload copied into target projects by the installer\n  - `framwork/.codeadd/plugins/`: plugin asset source tree (fragments and skills per plugin)\n\n## Compatibility\n\n- Node.js 18+\n- GitHub-hosted releases for distribution\n- Works on Windows, macOS, Linux (via Node runtime)\n\n## Contributing\n\nContributions are welcome. Start here:\n- [Contributing guide](./CONTRIBUTING.md)\n- [Code of Conduct](./CODE_OF_CONDUCT.md)\n- [Security policy](./SECURITY.md)\n\n## Official Pages\n\n- **Framework**: [code.brabos.ai](https://code.brabos.ai)\n- **Repository**: [github.com/brabos-ai/code-addiction](https://github.com/brabos-ai/code-addiction)\n- **NPM Package**: [@codeadd](https://www.npmjs.com/package/codeadd)\n\n## Support\n\n- Official site: [code.brabos.ai](https://code.brabos.ai)\n- Open a [GitHub Issue](https://github.com/brabos-ai/code-addiction/issues)\n- See [SUPPORT.md](./SUPPORT.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrabos-ai%2Fcode-addiction","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrabos-ai%2Fcode-addiction","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrabos-ai%2Fcode-addiction/lists"}