{"id":47234804,"url":"https://github.com/kompassdev/kompass","last_synced_at":"2026-04-01T20:25:38.194Z","repository":{"id":343501781,"uuid":"1177046192","full_name":"kompassdev/kompass","owner":"kompassdev","description":"Navigate your way - manual steering, steered autonomy, or autonomously. Kompass keeps AI coding agents on course with token-efficient, composable workflows.","archived":false,"fork":false,"pushed_at":"2026-03-28T14:58:40.000Z","size":10464,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-28T16:57:50.171Z","etag":null,"topics":["agent-navigation","ai","automation","autonomous-coding","code-review","coding-agent","developer-tools","github","kompass","steered-autonomy","token-efficiency","workflow"],"latest_commit_sha":null,"homepage":"https://kompassdev.ai/","language":"TypeScript","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/kompassdev.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-09T16:33:19.000Z","updated_at":"2026-03-28T14:22:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kompassdev/kompass","commit_stats":null,"previous_names":["kompassdev/kompass"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/kompassdev/kompass","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kompassdev%2Fkompass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kompassdev%2Fkompass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kompassdev%2Fkompass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kompassdev%2Fkompass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kompassdev","download_url":"https://codeload.github.com/kompassdev/kompass/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kompassdev%2Fkompass/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: 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":["agent-navigation","ai","automation","autonomous-coding","code-review","coding-agent","developer-tools","github","kompass","steered-autonomy","token-efficiency","workflow"],"created_at":"2026-03-13T22:02:38.504Z","updated_at":"2026-04-01T20:25:38.185Z","avatar_url":"https://github.com/kompassdev.png","language":"TypeScript","readme":"\u003e Kompass is under active development, so workflows, package APIs, and adapter support may keep evolving as the toolkit expands.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/kompassdev/kompass/main/assets/kompass.png\" alt=\"Kompass\" height=\"300\" /\u003e\n  \u003cbr\u003e\n  \u003cem\u003eNavigate your way - manual steering, steered autonomy, or autonomously.\u003c/em\u003e\n\u003c/p\u003e\n\nKompass keeps AI coding agents on course with token-efficient, composable workflows.\n\n## Docs\n\n- Main docs: https://kompassdev.ai/docs/\n- Getting started: https://kompassdev.ai/docs/getting-started/\n- OpenCode adapter: https://kompassdev.ai/docs/adapters/opencode/\n- Config reference: https://kompassdev.ai/docs/config/overview/\n- Command, agent, tool, and component reference: https://kompassdev.ai/docs/reference/commands/, https://kompassdev.ai/docs/reference/agents/, https://kompassdev.ai/docs/reference/tools/, https://kompassdev.ai/docs/reference/components/\n\n## Bundled Surface\n\n- Commands cover direct work (`/ask`, `/commit`, `/merge`), orchestration (`/dev`, `/ship`, `/todo`), ticket planning/sync, and PR review/shipping flows.\n- Agents are intentionally narrow: `worker` is generic, `planner` is no-edit planning, `navigator` owns multi-step orchestration, and `reviewer` is a no-edit review specialist.\n- Structured tools keep workflows grounded in repo and GitHub state: `changes_load`, `session_command` (resolve a slash command and queue it into the current session), `pr_load`, `pr_sync`, `ticket_load`, `ticket_sync`.\n- Reusable command-template components live in `packages/core/components/` and are documented in the components reference.\n\n## Installation\n\nFor OpenCode, add the adapter package to your config:\n\n```json\n{\n  \"plugin\": [\"@kompassdev/opencode\"]\n}\n```\n\nProject config is optional. To start from the published base config:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/kompassdev/kompass/main/kompass.jsonc -o .opencode/kompass.jsonc\n```\n\nKompass loads the bundled base config, then optional home-directory overrides, then optional project overrides. In each location it uses the first file that exists from:\n\n- `.opencode/kompass.jsonc`\n- `.opencode/kompass.json`\n- `kompass.jsonc`\n- `kompass.json`\n\nThe recommended project override path is `.opencode/kompass.jsonc`.\n\n## Workspace\n\nThis repository is the Kompass development workspace.\n\n- `packages/core`: shared workflows, prompts, components, config loading, and tool definitions\n- `packages/opencode`: the OpenCode adapter package, published as `@kompassdev/opencode`\n- `packages/web`: docs site and web content\n- `packages/opencode/.opencode/`: generated OpenCode output for review\n\nWhen changing Kompass itself, keep runtime definitions, bundled config, schema, docs, and generated output in sync in the same change.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkompassdev%2Fkompass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkompassdev%2Fkompass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkompassdev%2Fkompass/lists"}