{"id":47745188,"url":"https://github.com/defai-digital/ax-code","last_synced_at":"2026-05-03T09:01:53.056Z","repository":{"id":346888981,"uuid":"1191049117","full_name":"defai-digital/ax-code","owner":"defai-digital","description":"AI coding runtime for the business production environment","archived":false,"fork":false,"pushed_at":"2026-04-18T23:08:14.000Z","size":81820,"stargazers_count":0,"open_issues_count":20,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T23:38:27.768Z","etag":null,"topics":["automatosx","cli-app","coding","developer-tools","vibe-coding"],"latest_commit_sha":null,"homepage":"","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/defai-digital.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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":null,"dco":null,"cla":null}},"created_at":"2026-03-24T21:47:42.000Z","updated_at":"2026-04-18T23:08:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/defai-digital/ax-code","commit_stats":null,"previous_names":["defai-digital/ax-code"],"tags_count":188,"template":false,"template_full_name":null,"purl":"pkg:github/defai-digital/ax-code","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defai-digital%2Fax-code","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defai-digital%2Fax-code/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defai-digital%2Fax-code/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defai-digital%2Fax-code/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/defai-digital","download_url":"https://codeload.github.com/defai-digital/ax-code/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/defai-digital%2Fax-code/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32116514,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T00:31:26.853Z","status":"ssl_error","status_checked_at":"2026-04-22T00:30:22.894Z","response_time":128,"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":["automatosx","cli-app","coding","developer-tools","vibe-coding"],"created_at":"2026-04-03T00:38:41.857Z","updated_at":"2026-05-01T06:05:06.142Z","avatar_url":"https://github.com/defai-digital.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n___________  __     _________________________________\n___    |_  |/ /     __  ____/_  __ \\__  __ \\__  ____/\n__  /| |_    /_______  /    _  / / /_  / / /_  __/\n_  ___ |    |_/_____/ /___  / /_/ /_  /_/ /_  /___\n/_/  |_/_/|_|       \\____/  \\____/ /_____/ /_____/\n```\n\n**AI coding runtime for teams that need control, auditability, and extensibility, not just code suggestions.**\n\nAX Code is an AI execution runtime for software development. It combines agents, tool execution, provider routing, session state, and configurable isolation into one system that can run in the terminal, inside VS Code, through the SDK, or as a headless service.\n\n- Controlled execution with configurable sandbox and permissions\n- Provider flexibility across cloud and local model backends\n- Persistent sessions, replay, and project context through `AGENTS.md`\n- One runtime across TUI, CLI, SDK, VS Code, and server mode\n- Extensible with MCP servers, plugins, and custom integrations\n\nBuilt by [DEFAI Digital](https://github.com/defai-digital).\n\n[![ax-code](https://github.com/defai-digital/ax-code/actions/workflows/ax-code-ci.yml/badge.svg)](https://github.com/defai-digital/ax-code/actions/workflows/ax-code-ci.yml)\n[![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord\u0026logoColor=white)](https://discord.gg/cTavsMgu)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n---\n\n## Get Started in 60 Seconds\n\n### Install\n\n```bash\n# Homebrew (macOS / Linux)\nbrew install defai-digital/ax-code/ax-code\n\n# npm (any platform)\nnpm i -g @defai.digital/ax-code\n```\n\n### Verify\n\n```bash\nax-code doctor\n```\n\nLook for the `Runtime` line:\n\n| Output                              | Meaning                                        |\n| ----------------------------------- | ---------------------------------------------- |\n| `Runtime: Bun X.Y.Z (compiled)`     | Default Homebrew/npm install — compiled binary |\n| `Runtime: Bun X.Y.Z (bun-bundled)`  | `ax-code-source` compatibility package         |\n| `Runtime: Bun X.Y.Z (source)`       | Local checkout via `pnpm setup:cli`            |\n\n### Run\n\n```bash\n# Set any provider key (pick one)\nexport ANTHROPIC_API_KEY=\"your-key\"              # Claude\nexport GOOGLE_GENERATIVE_AI_API_KEY=\"your-key\"   # Gemini\nexport XAI_API_KEY=\"your-key\"                    # Grok\nexport OPENAI_API_KEY=\"your-key\"                 # GPT\n\n# Launch\nax-code\n```\n\nThat's it. No project setup or config file is required. Run `ax-code`, then use `/connect` inside the TUI to add or switch providers.\n\n### Update\n\n`ax-code upgrade` and package-manager update commands apply to the compiled runtime shipped by the default package.\n\n```bash\nax-code upgrade\nbrew upgrade ax-code\nnpm update -g @defai.digital/ax-code   # follows your installed dist-tag\n```\n\n### Distribution note\n\nThe supported user install path now ships the compiled binary under the normal `ax-code` package/formula. The source+bun launcher remains available as the `ax-code-source` compatibility channel for diagnosis or fallback.\n\n### From Source (contributors)\n\n```bash\ngit clone https://github.com/defai-digital/ax-code.git\ncd ax-code \u0026\u0026 pnpm install \u0026\u0026 pnpm run setup:cli\n```\n\nRequires [pnpm](https://pnpm.io) v9.15.9+ and [Bun](https://bun.sh) v1.3.13+. `setup:cli` installs a launcher for the same bundled runtime used by npm and Homebrew. `ax-code doctor` should report `Runtime: Bun X.Y.Z (compiled)`.\n\nRefresh the local bundled runtime after code changes:\n\n```bash\npnpm --dir packages/ax-code run build -- --single\npnpm run setup:cli -- --rebuild\nax-code doctor\n```\n\nFor contributor-only source debugging, install the checkout-bound launcher explicitly:\n\n```bash\npnpm run setup:cli -- --source\n```\n\n---\n\n## Why AX Code\n\nMost AI coding tools optimize for a chat loop. AX Code is built as a runtime you can actually operate across repositories, teams, and integration surfaces.\n\n- Use explicit tools instead of opaque background behavior.\n- Put boundaries around execution with `full-access`, `workspace-write`, or `read-only`.\n- Switch providers or move to local inference without changing the workflow.\n- Resume, fork, compact, export, and audit sessions instead of losing work in a tab.\n- Reuse the same runtime in the terminal, VS Code, CI jobs, or internal platforms.\n\nAX Code is not just a chat UI. It is the runtime layer behind agent selection, tool orchestration, session persistence, and policy boundaries.\n\n## When It Fits\n\nAX Code is a strong fit when you need one or more of these:\n\n- Large or messy repositories where uncontrolled tool use is risky\n- Team workflows that need repeatability, reviewability, or policy boundaries\n- Provider choice across hosted and local model backends\n- Embeddable agent workflows through a TypeScript SDK or headless server\n- Repository-specific context that can live with the code in `AGENTS.md`\n\n## Use It Your Way\n\n| Surface        | Best for                          | Entry point                                                                      |\n| -------------- | --------------------------------- | -------------------------------------------------------------------------------- |\n| TUI            | Interactive repo work             | `ax-code`                                                                        |\n| One-shot CLI   | Quick tasks and scripts           | `ax-code run \"review the auth flow\"`                                             |\n| Server mode    | CI, bots, and internal platforms  | `ax-code serve`                                                                  |\n| TypeScript SDK | Embedding ax-code in applications | [`packages/sdk/js/README.md`](packages/sdk/js/README.md)                         |\n| VS Code        | Editor-native workflow            | [`packages/integration-vscode/README.md`](packages/integration-vscode/README.md) |\n\n## Core Workflow\n\n1. Connect a provider with environment variables or `ax-code providers login`.\n2. Launch `ax-code` and use `/connect` if you want to switch models from the TUI.\n3. Run `ax-code init` so `AGENTS.md` captures project-specific instructions and conventions.\n4. Turn on sandboxing with `--sandbox workspace-write` or `/sandbox` when you want bounded execution.\n5. Run `ax-code index` on larger repos for faster semantic and code-intelligence workflows.\n\n## Documentation\n\n- [Start Here](docs/start-here.md): understand what AX Code is, where the value comes from, and which docs to read next\n- [Documentation Hub](docs/README.md): guides, architecture, specs, and reference docs\n- [Sandbox Mode](docs/sandbox.md): isolation modes, protected paths, and network controls\n- [Autonomous Mode](docs/autonomous.md): unattended execution behavior and safeguards\n- [Auto-Route](docs/auto-route.md): LLM-assisted agent routing and model selection\n- [Semantic Layer](docs/architecture/semantic-layer.md): provenance and replay boundaries for graph and LSP-backed answers\n\n## Common Commands\n\n```bash\nax-code\nax-code run \"debug why the build is failing\"\nax-code providers login\nax-code models\nax-code init\nax-code index\nax-code mcp add\nax-code serve\nax-code doctor\n```\n\n## Security and Operations\n\nAX Code includes configurable isolation modes, protected paths for `.git` and `.ax-code` in sandboxed runs, encrypted provider and MCP credentials at rest, and localhost-only server defaults. See [SECURITY.md](SECURITY.md) for the threat model and [docs/sandbox.md](docs/sandbox.md) for isolation behavior and configuration.\n\n## Project Notes\n\nAX Code combines ideas from [ax-cli](https://github.com/defai-digital/ax-cli) and [OpenCode](https://github.com/anomalyco/opencode) into the developer-facing runtime of the broader AutomatosX ecosystem.\n\n## Community\n\nReport bugs, feature requests, and questions through [GitHub Issues](https://github.com/defai-digital/ax-code/issues). See [CONTRIBUTING.md](CONTRIBUTING.md) for the current contribution policy and [Discord](https://discord.gg/cTavsMgu) for community discussion.\n\n## License\n\n[MIT](LICENSE) — Copyright (c) 2025 [DEFAI Private Limited](https://github.com/defai-digital). Portions derived from [OpenCode](https://github.com/anomalyco/opencode), Copyright (c) 2025 opencode.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdefai-digital%2Fax-code","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdefai-digital%2Fax-code","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdefai-digital%2Fax-code/lists"}