DocsAgenC Core

Core: getting started

Install the AgenC coding agent, run it in the terminal or headless, sign in with X for Grok, pick providers, and embed it with the SDK.

View as Markdown ›

AgenC Core is a powerful and extensible coding agent. Use it through the interactive TUI, headlessly in scripts and bots, or embedded in your own apps over the daemon protocol. One local daemon owns sessions, permissions, provider calls, and command execution.

Install

macOS / Linux:

curl -fsSL https://get.agenc.ag/install.sh | sh

No curl? The npm launcher installs the same runtime:

npm install -g @tetsuo-ai/agenc

Standalone installs carry a private, verified Node.js runtime — no host Node required.

Start an interactive session

cd your-project
agenc

On first launch, agenc onboard walks provider setup: sign in with X or xAI to use Grok on your subscription — no API key required — or paste provider keys. Inside the TUI the same rail is one command away:

/grok-login

In non-browser environments, use a key instead:

export XAI_API_KEY="xai-..."
agenc

Useful first prompts:

Explain this repo.
Create a todo checklist and fix the failing test.

Run headlessly

agenc -p "Explain this codebase"
agenc --no-tui "Summarize open TODOs"

Headless mode is built for scripts, CI, and bots. The same daemon owns sessions either way, so runs stay durable and resumable.

Providers and models

16 built-in providers, with grok-4.5 as the fresh-config default (500k context). Check readiness and switch:

agenc providers
agenc config set model grok-4.5

Or switch inside the TUI with /model <name>.

Embed with the SDK

@tetsuo-ai/agenc-sdk speaks the daemon protocol from your own app:

import { connect } from "@tetsuo-ai/agenc-sdk";
 
const client = await connect({ autostart: true });
const session = await client.createSession();
const run = session.prompt("Summarize this repo.");
 
for await (const event of run) {
  if (event.type === "text") process.stdout.write(event.delta);
}

Next