contenox
Local-first AI workflow runtime

AI workflows you can run, review, and own.

Package repeatable coding work into versioned Chains, connect the models and tools you choose, and run them from the CLI, VS Code, or ACP clients with explicit approval gates. No hosted Contenox service required.

$ curl -fsSL https://contenox.com/install.sh | sh

Installs contenox. Run contenox init to scaffold a workspace.

Live from Beam, the bundled local web UI: the agent asks to run a shell command, waits at the approval gate, and reports back. contenox serve opens the same sessions, chains, and backends in the browser.

GitHub stars Latest release Apache-2.0

Core capabilities

The Chain is the contract

Prompts, model routing, tool allowlists, command policy, budgets, and approval gates are visible keys in a versioned file — reviewable, diffable, repeatable.

Runs where work happens

One runtime behind the CLI, the VS Code extension, and any ACP editor. Same chains, same sessions, same policy everywhere.

Providers are config

Route inference to local modeld, Ollama, vLLM, OpenAI, Anthropic, Mistral, Gemini, OpenRouter, Bedrock, or Vertex — without touching the workflow.

Local by default

Sessions, config, run logs, and state live in SQLite on your machine. No hosted Contenox service, no account, no telemetry.

Terminal demo: a destructive rm command stops at a human approval gate before it runs

Contenox is not just a chatbot, not just a VS Code extension, and not just an agent framework. It is a local-first workflow runtime for specific, reviewable AI work.

Nearby world Why Contenox is different
Cursor / IDE copilots Runtime-first, not editor-first. The same engine works from the terminal, VS Code, and ACP clients.
Aider / CLI coding agents Broader workflow, session, tool policy, and provider scope than a single coding loop.
LangChain / agent frameworks End-user executable product, not just a library you wire into an application.
Dify / n8n / web AI workflow tools Local desktop/workspace-first, not web-app or SaaS-first.
Ollama wrappers Provider-neutral and workflow/tool/HITL-oriented, with local and hosted models.

What you can author

Repeatable work, with policy in the file.

Run it where work happens

The same chain can run in your editor, terminal, or automation.

Contenox ships a native VS Code extension, and speaks the Agent Client Protocol over stdio for other editors. Use VS Code, Zed, JetBrains, or AionUi when an editor UI helps; keep the workflow itself in the chain file, with tool calls and HITL approvals routed through the client.

// ~/.config/zed/settings.json
{
  "agent_servers": {
    "Contenox": {
      "type": "custom",
      "command": "contenox",
      "args": ["acp"]
    }
  }
}

Built on open standards

Speaks the protocols your tools already use.

Built on

Local inference links these upstream projects at build time; their runtime libraries and license texts ship inside each release package. Hosted providers connect over their public APIs.

Get started

Own your AI workflows in the next five minutes.

$ curl -fsSL https://contenox.com/install.sh | sh

Questions? hello@contenox.com · Issues and PRs on GitHub

Esc to close