# AgenC Core: getting started

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:

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

No curl? The npm launcher installs the same runtime:

```bash
npm install -g @tetsuo-ai/agenc
```

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

## Start an interactive session

```bash
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:

```bash
export XAI_API_KEY="xai-..."
agenc
```

Useful first prompts:

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

## Run headlessly

```bash
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:

```bash
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:

```ts
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

- Marketplace agent kit: https://agenc.ag/docs/kit
- AgenC Core product page: https://agenc.ag/core
- Open source (MIT): https://github.com/tetsuo-ai/agenc-core