AgenC Core

# AgenC Core

> Daemon-backed coding agent: interactive TUI, headless print mode, background
> agents, multi-channel gateway, budget-bounded autonomy, and a typed embedding SDK.

![status](https://img.shields.io/badge/status-stable-brightgreen)
![version](https://img.shields.io/badge/version-0.17.0-blue)
![node](https://img.shields.io/badge/node-26.x-339933?logo=node.js&logoColor=white)
![TypeScript](https://img.shields.io/badge/TypeScript-strict%20%E2%80%A2%200%20%40ts--nocheck-3178C6?logo=typescript&logoColor=white)

**AgenC Core** is the implementation repository for the `agenc` CLI. A local
daemon owns agent/session lifecycle, permissions, provider calls, and command
execution. The interactive TUI, headless `--print` / `--no-tui` CLI, background
agents, channel gateway, and remote phone bridge are all clients of that daemon.

| Package | Path | Role |
| --- | --- | --- |
| `@tetsuo-ai/agenc` `0.17.0` | `packages/agenc/` | Public launcher binary |
| `@tetsuo-ai/runtime` `0.17.0` | `runtime/` | Daemon, TUI, tools, providers, tests |
| `@tetsuo-ai/agenc-sdk` `0.3.0` | `packages/agenc-sdk/` | Typed embedding SDK (daemon protocol) |

Documentation map: [`docs/INDEX.md`](docs/INDEX.md). Architecture:
[`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md). CLI reference:
[`docs/reference/cli.md`](docs/reference/cli.md).

## Contents

- [Features](#features)
- [Project status](#project-status)
- [Requirements](#requirements)
- [Quick start](#quick-start)
- [Usage](#usage)
- [Configuration](#configuration)
- [Architecture](#architecture)
- [Development](#development)
- [Security](#security)
- [Contributing](#contributing)
- [License](#license)

## Features

- **Daemon-backed process model** — launcher → daemon (`app-server`) → TUI /
  print / agents / gateway clients. One control plane per `AGENC_HOME`.
- **Two front-ends** — interactive React TUI and headless one-shot mode
  (`agenc -p|--print`, `agenc --no-tui`).
- **Background agents** — fire-and-forget sessions (`agenc agent start|list|
  attach|stop|logs`), attachable and resumable, independent of the foreground UI.
- **Channel gateway** — Telegram, Discord, Slack, WebChat, and stdio channels;
  pairing, bindings, in-channel approvals. See [`docs/gateway.md`](docs/gateway.md).
- **Budget-bounded execution** — daemon-owned reservations, hierarchical caps,
  concurrency, cancellation, and evidence across interactive/background work,
  including heartbeat / cron / hooks. Design:
  [`docs/design/execution-admission-kernel.md`](docs/design/execution-admission-kernel.md).
- **Guided onboarding** — `agenc onboard` includes AgenC account sign-in,
  X / xAI sign-in for Grok, provider API keys, and local providers without
  requiring slash commands; follow-on acts: `identity`, `channel`, `autonomy`,
  `recap` (personas, channels, budget/heartbeat/webhooks).
- **Remote control** — pair iOS or Android with `agenc remote on|off|status`;
  co-drive chats, receive background completion/attention events, and settle
  permissions from the phone. Android can route an explicit, physically
  approved `@ledger` SOL transfer to a Ledger Flex. See
  [`docs/remote-control.md`](docs/remote-control.md) and the
  [Ledger security contract](docs/security/mobile-ledger-transfer.md).
- **Ledger Wallet CLI** — Ledger hardware-wallet requests route through a
  bundled skill and a read-only CLI status tool. If the official
  `wallet-cli` is missing, AgenC asks before downloading anything; an approved
  `/ledger install` (or agent install action) resolves
  `@ledgerhq/wallet-cli@latest`, verifies the platform package's SHA-512
  integrity, and installs it under `AGENC_HOME`.
- **Built-in tools** — Bash, file read/write/edit, transactional `apply_patch`,
  web fetch/search, LSP, MCP, sub-agents; read-before-write and atomic-patch safety.
- **Browser automation** — the `Browser` tool drives an isolated Chromium over a
  CDP pipe with stable accessibility refs (navigate, snapshot, click, type,
  screenshot, tabs). All eg

… (truncated)