Copied

[ AGENT ]

Terminal coding agent

dxa-agent is an open-source CLI published as @dxa-dev/agent on npm. You work in your terminal with pluggable model backends, built-in tools, and MCP—whether you use cloud APIs or run models locally (for example with Ollama).

[ OVERVIEW ]#

@dxa-dev/agent MIT license

Run one command—dxa-agent—for a full terminal coding agent: switch between model backends (Anthropic Claude, OpenAI-compatible APIs, Gemini, GitHub Models, Ollama, Atomic Chat, and others), use tools and MCP, and drive the session with slash commands. The distribution also includes a VS Code extension and a dark terminal theme so you can stay in-editor if you prefer.

Tools & MCP Cloud or local models VS Code Node.js
Source & issues npm License

[ WHY USE IT ]#

  • One CLI for cloud APIs and local inference.
  • /provider walks you through setup and saved profiles.
  • Bash, file tools, grep/glob, agents, tasks, MCP, web helpers, and slash commands.
  • Optional VS Code integration ships in the same project.

[ INSTALL ]#

You need Node.js 20+ and ripgrep (rg) on your PATH. If the CLI says ripgrep is missing, fix PATH and open a new terminal window. 

npm install -g @dxa-dev/agent

Install on npm

[ FIRST RUN ]# 

dxa-agent

After it starts, use /provider for guided provider setup and /onboard-github if you use GitHub Models. Beginner-oriented setup, checklists, and platform quick starts live in the project documentation—open the docs index when you are ready to go deeper.

Provider tables, environment templates, advanced setup, and troubleshooting are maintained in docs/ alongside the code.

[ WHAT YOU GET ]#

Tooling & workflow

  • Tool-driven coding: bash, file read/write/edit, grep, glob, agents, tasks
  • MCP and slash commands
  • Streaming output and multi-step tool loops
  • Provider profiles and optional routing across models

Models & backends

Works with cloud APIs, local servers, and compatible stacks—Anthropic, OpenAI-compatible endpoints, Gemini, GitHub Models, Ollama, and others. Capabilities differ by provider and model; the bundled documentation spells out setup paths and limitations.

[ RUNTIME ]#

The published CLI targets Node.js 20+. If you clone the project to hack on it, the repo’s scripts expect Bun for builds and tests—see CONTRIBUTING.md.

[ COMMON QUESTIONS ]#

Does dxa-agent compile or run a particular programming language?
No. It is a general-purpose terminal agent for everyday coding tasks with LLMs. It is not a language compiler and does not execute a dedicated “agent language” bytecode—your models and tools drive the session.
Do I need a GPU or paid APIs?
No hard requirement. You can point the CLI at local inference (for example Ollama on your machine) or at cloud APIs—whatever matches your budget and policy. Smaller local models may struggle with long tool-heavy sessions; the docs discuss trade-offs.
Where is the full documentation?
This page is an overview. Install guides, provider matrices, env examples, and troubleshooting are in the project’s docs/ tree.

[ COMMUNITY ]#

  • Releases — track versions and notes on the releases page.
  • Discuss & report — use Discussions for questions and Issues for bugs or focused requests.
  • Contribute — clone, build, and CI expectations are in CONTRIBUTING.md.

Not affiliated with Anthropic or other vendors. Names are used descriptively only; see LEGAL.md in the repository.