Copied

[ DXA · TERMINAL ]

Deimos

LLM coding in your terminal: pluggable models, tools, MCP, and slash commands—point it at cloud APIs or local inference (for example Ollama). MIT licensed; install @dxa-deimos/cli and run deimos.

▸ DEIMOS//NET · CARRIER · UPLINK HANDSHAKE
▸ OUTER MOON · SUB-KM BODY · TIDE-LOCK · TRACE ONLY

[ DEIMOS // LORE ]#

In myth, Deimos and Phobos flank Ares—Fear and Terror beside the war god, not the fight itself. In the sky, Deimos is Mars’s outer moon: a small tide-locked rock, dark regolith, slow orbit, one face toward the planet. That name is on this terminal because the job matches: a narrow channel, face toward the work, no performative orbit. The DEIMOS//NET frame in the CLI (rings, carrier HUD, animated box) is fiction; your session, models, and tools are the real uplink.

The outer moon

Hall, 1877, with Phobos. ~15 km, dim regolith; orbit ~30.3 h—slower than a Martian sol—so it is the distant companion, not the inner moon that streaks across the sky.

DEIMOS//NET

Welcome frame and HUD strings set tone—markers, sol counts, industrial isolation—not astronomy claims.

Why this name on the prompt

This CLI is the DXA stack’s terminal for models, tools, MCP, and slash commands—not the compiler or language VM. Deimos fits something small, locked in, beside the work: a cockpit you steer.

[ OVERVIEW ]#

@dxa-deimos/cli MIT license

One CLI: switch models and endpoints, run tools and MCP, and use slash commands for workflow. Backends include Anthropic, OpenAI-compatible servers, Gemini, GitHub Models, Ollama, Atomic Chat, and others—capabilities vary by provider. The repo also ships a VS Code extension and a terminal theme if you want the same vibe in-editor.

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

[ WHY USE IT ]#

  • /provider for guided setup and saved profiles—cloud or local.
  • Bash, file tools, grep/glob, tasks, MCP, streaming output, slash commands.
  • Optional VS Code integration in the same repository.

[ INSTALL ]#

You need Node.js 22+ 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-deimos/cli

Install on npm

[ FIRST RUN ]# 

deimos

Run /provider to configure backends; use /onboard-github if you rely on GitHub Models. Deeper setup lives in the documentation index and the docs/ tree.

[ WHAT YOU GET ]#

Tooling

  • File and shell tools, grep/glob, multi-step tool loops, tasks
  • MCP servers and slash-command workflow
  • Profiles so you can swap models without losing your setup

Backends

Cloud APIs, local inference, and compatible gateways—behavior depends on provider and model. Use docs/ for matrices, env templates, and limits.

[ RUNTIME ]#

The published CLI targets Node.js 22+ (see engines in the package). 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 Deimos compile or run DEXA (or another language) by itself?
No. The deimos CLI is a general-purpose terminal for everyday coding with LLMs. It is not the DEXA compiler and does not execute a dedicated VM bytecode—your models and tools drive the session. Use the Playground or dxc for DEXA.
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?
In the repo’s docs/ tree and the links section below.

[ COMMUNITY ]#

Releases for versions, Discussions / Issues for talk and bugs, CONTRIBUTING.md to hack on the repo. Raw URLs are in Links.

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