{"id":50287821,"url":"https://github.com/badguyfranco/cocoder","last_synced_at":"2026-05-28T04:00:28.844Z","repository":{"id":359682999,"uuid":"1246912067","full_name":"BadGuyFranco/cocoder","owner":"BadGuyFranco","description":"Open, self-improving AI coding orchestration for solo builders and small teams. Apache-2.0. Mechanically extracted from CoBuilder per ADR-0004.","archived":false,"fork":false,"pushed_at":"2026-05-22T23:39:56.000Z","size":471,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T00:25:33.869Z","etag":null,"topics":["ai","ai-agents","ai-coding","apache-2","developer-tools","nodejs","orchestration","typescript"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BadGuyFranco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-22T17:35:46.000Z","updated_at":"2026-05-22T23:39:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/BadGuyFranco/cocoder","commit_stats":null,"previous_names":["badguyfranco/cocoder"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/BadGuyFranco/cocoder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadGuyFranco%2Fcocoder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadGuyFranco%2Fcocoder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadGuyFranco%2Fcocoder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadGuyFranco%2Fcocoder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BadGuyFranco","download_url":"https://codeload.github.com/BadGuyFranco/cocoder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadGuyFranco%2Fcocoder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33593400,"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-05-28T02:00:06.440Z","response_time":99,"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","ai-agents","ai-coding","apache-2","developer-tools","nodejs","orchestration","typescript"],"created_at":"2026-05-28T04:00:16.024Z","updated_at":"2026-05-28T04:00:28.836Z","avatar_url":"https://github.com/BadGuyFranco.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CoCoder\n\nCoCoder is an open, local-first AI coding orchestration framework for solo builders and small teams. It packages the proven CoBuilder orchestration runtime as a reusable CLI, workspace template, persona contract system, and local Oz dashboard.\n\nUse it when you want AI coding sessions to start from explicit priorities, bounded write scopes, durable evidence, and repeatable result artifacts instead of ad hoc chat threads.\n\n## What v0.1 includes\n\n- A `cocoder` CLI for workspace setup, launch composition, lane startup, contract validation, and local audit checks.\n- A tracked `cocoder/` workspace structure for priorities, session logs, ADRs, tickets, memory, standards, routes, profiles, and personas.\n- A workspace template created by `cocoder init`.\n- Oz, a loopback-only browser dashboard for workspace registration, priority launch, run listing, and run inspection.\n- Public docs for first launch, orchestration, personas, configuration, Oz, freshness policy, and FAQ.\n- Apache-2.0 licensing with CoBuilder extraction attribution in `NOTICE`.\n\n## Requirements\n\n- macOS first for v0.1\n- Node.js version from `.nvmrc`\n- pnpm 10.x\n- tmux\n- At least one configured model CLI adapter named by the selected profile\n\n## Quick Start\n\nInstall CoCoder:\n\n```sh\ngit clone \u003cCoCoder-repo-url\u003e ~/dev/CoCoder\ncd ~/dev/CoCoder\npnpm install\npnpm -F cocoder-cli build\npnpm exec cocoder validate-contracts\nexport COCODER_HOME=\"$PWD\"\n```\n\nInitialize an application workspace outside the CoCoder install:\n\n```sh\nmkdir -p ~/dev/my-app\ncd ~/dev/my-app\ngit init\npnpm --dir \"$COCODER_HOME\" exec cocoder init \\\n  --workspace-root \"$PWD\" \\\n  --cocoder-home \"$COCODER_HOME\"\n```\n\nThen follow [`docs/getting-started.md`](./docs/getting-started.md) for the full path from clean clone to first CLI or Oz launch.\n\n## Mental Model\n\nCoCoder has two public surfaces and two private surfaces:\n\n- The CoCoder install repo contains the engine, schemas, templates, docs, and dashboard source.\n- `\u003cCoCoder\u003e/local/` stores install-private preferences, workspace registry data, audit logs, and secrets.\n- Each application repo gets a tracked `cocoder/` workspace folder for priorities, ADRs, tickets, memory, standards, and persona contracts.\n- Each application repo also gets ignored `cocoder/local/` overrides for machine-local settings and secrets.\n\nGit updates the engine and templates. Ignored `local/` directories preserve operator preferences and run records.\n\nFor the full storage-zone model, see [`ARCHITECTURE.md`](./ARCHITECTURE.md). For commercial use, telemetry, trademark, and sync guidance, see [`docs/faq.md`](./docs/faq.md).\n\n## Documentation\n\n- [`docs/getting-started.md`](./docs/getting-started.md) - clean-clone to first launch.\n- [`docs/orchestration.md`](./docs/orchestration.md) - runs, dispatch, evidence, and result artifacts.\n- [`docs/personas.md`](./docs/personas.md) - core role contracts and write capability.\n- [`docs/configuration.md`](./docs/configuration.md) - install/workspace config, path resolution, and terminal invocation.\n- [`docs/oz.md`](./docs/oz.md) - dashboard overview and troubleshooting.\n- [`docs/oz-launch.md`](./docs/oz-launch.md) - command-by-command Oz launch flow.\n- [`docs/oz-security-checklist.md`](./docs/oz-security-checklist.md) - local daemon security checklist.\n- [`docs/freshness-policy.md`](./docs/freshness-policy.md) - doc verification stamps and release-candidate audit cadence.\n\n## Local Development\n\n```sh\npnpm install\npnpm -F schemas build\npnpm -F core test\npnpm -F oz-dashboard test\npnpm exec cocoder validate-contracts\n```\n\nThe public CLI package builds a `cocoder` binary:\n\n```sh\npnpm -F cocoder-cli build\npnpm exec cocoder config get\n```\n\n## Contributing\n\nCoCoder is solo-maintained early-stage OSS. Outside contributions are welcome on the terms documented in [`CONTRIBUTING.md`](./CONTRIBUTING.md). For open-ended questions and design discussions use [Discussions](https://github.com/BadGuyFranco/cocoder/discussions); for bugs and concrete proposals use [Issues](https://github.com/BadGuyFranco/cocoder/issues). For security reports see [`SECURITY.md`](./SECURITY.md) - never file a public issue for a vulnerability.\n\nBehavior expectations: [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md).\n\n## License\n\nApache-2.0. See [`LICENSE`](./LICENSE) and [`NOTICE`](./NOTICE). The orchestration core under `packages/core/` is mechanically extracted from upstream CoBuilder; attribution requirements live in `NOTICE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadguyfranco%2Fcocoder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbadguyfranco%2Fcocoder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadguyfranco%2Fcocoder/lists"}