Getting agents to do things isn't the hard part anymore. Keeping track of everything they do —
without losing context, missing changes, or creating messes you can't untangle — is.
AGX is how I use agents seriously. Works with Claude, Codex, Gemini, and Ollama.

npm install -g @mndrk/agx && agx init

AGX is a local workspace for running coding agents across your tickets, repos, and PRs — you stay the author.

Website • Blog • Install • Features • How It Works • CLI

Hi, I'm Mendrika.

I built AGX because I kept wanting to use agents for more and more real work. Feature builds. Bug fixes. Research. Follow-up tasks. The problem was never getting them to do things. The problem was keeping track of everything without getting lost.

That started to feel like the real bottleneck. The better the agents got, the more parallel work I wanted to run. And the more parallel work I ran, the easier it was to lose context, miss changes, and create messes I couldn't reliably untangle.

AGX is my attempt to solve that. It's an exploration of what it would take to use agents seriously, while still staying in control.

Ships as a CLI, a local web dashboard, and a macOS desktop app — all from one repo.

npm install -g @mndrk/agx
cd my-project
agx init                   # Picks up your API keys automatically
agx board start            # Open the ticket → agent → PR board

npm install -g @mndrk/agx
cd my-project
agx init                   # First-time setup — picks up your API keys
agx board start            # Open the local dashboard

Download from Releases. Bundles the UI, CLI, and Node runtime — install and go.

git clone https://github.com/ramarlina/agx.git
cd agx && npm install
npm run local:dev          # Run the dashboard in dev mode

• Ticket → agent → PR loop — Point an agent at a Jira or Linear ticket, review the draft, ship the PR. Your tickets, repos, and PRs live in one window.
• Human-in-the-loop at every gate — Agents pause for your explicit approve/reject before anything irreversible. PR review starts with a first-pass from a reviewer agent so you spend judgment where it matters.
• Chat with any provider — Claude, Codex, Gemini, Ollama. Switch freely mid-thread.
• A home for every ticket — Objectives, scheduled jobs, chat threads, and terminal sessions all live under their project. Nothing is free-floating.
• Agent teams — Group agents by role (engineering, research, ops). Work routes automatically by tag.
• Survives restarts — Close your laptop, pick it up tomorrow. State is checkpointed, not rebuilt from conversation history.
• Live presence — See which agents are active on which projects and tickets in real time.
• Fully local — Runs on your machine. Your code never leaves. Full activity log, signed actions, destructive-command safeguards.

AGX runs the ticket → implementation → PR → review loop. Tickets from Jira or Linear come in, agents draft the work, humans approve at every gate, and PRs go out.

Under the hood, work is checkpointed at every step — so closing your laptop, restarting the machine, or coming back tomorrow all pick up exactly where you left off. Resuming is constant-cost: a thread that's been running for a week resumes as fast as one that started a minute ago.

• State layer — SQLite (WAL mode), durable checkpoints
• CLI + daemon — Provider tool calls, filesystem edits, worktree isolation
• Decision layer — Human gate transitions, review flow

Everything runs locally. Your code never leaves your machine.

agx init                         # First-time setup
agx board start                  # Open the ticket → agent → PR board
agx claude -p "..."              # Chat with Claude (or codex / gemini / ollama)

agx project list                           # List projects
agx repo add . --project my-project        # Analyze current repo and attach it
agx repo add ../service --project my-project --name API
agx workspace list --project my-project    # Show workspace map entries by category
agx workspace add repos backend /code/api --project my-project
agx workspace remove repos backend --project my-project

agx vars set API_URL https://example.com    # Set a variable
agx vars get API_URL                        # Get a variable
agx vars list                               # List all variables

agx init                       # First-time setup wizard
agx config                     # Reconfigure providers, models, backend URL

• Node.js >= 22.16.0 (CLI install only; desktop app bundles its own runtime)
• At least one AI provider CLI: Claude Code · Codex CLI · Gemini CLI · Ollama

No external database required. AGX uses SQLite locally.

agx/
  apps/
    local/          # Next.js dashboard (project home, chat, terminal, teams, objectives, tasks)
    desktop/        # Electron macOS app (bundles dashboard, CLI, and Node runtime)
  lib/              # CLI and runtime source
  commands/         # CLI command implementations
  cloud-runtime/    # Packaged standalone dashboard bundled into the npm artifact

npm install
npm run local:dev        # Start the dashboard at localhost

npm run local:build      # Production build
npm run board:bundle     # Package standalone runtime for the CLI

cd apps/desktop
npm run dev              # Launch Electron in dev mode
npm run build:mac        # Build the macOS .app + .dmg

agx telemetry off
# or: export AGX_TELEMETRY=0
# or: ~/.agx/config.json → { "telemetry": { "enabled": false } }

MIT

Direct the work. Let agents handle the busywork. Stay the author.

⭐ Star this repo if AGX saves you time · Report a bug · runagx.com