# Aster

> Documentation for Aster, the terminal coding agent.

## Start

- [Introduction](https://docs.withaster.dev/index.md): Aster is an open-source coding agent that reads your code, edits files, runs commands, and reviews changes, with any model you choose.
- [Getting started](https://docs.withaster.dev/getting-started.md): Install Aster, connect a model, and run your first turn in a repository.

## Using Aster

- [Chat](https://docs.withaster.dev/chat.md): The TUI, keys, slash commands, one-shot mode, and streaming.
- [Sessions](https://docs.withaster.dev/sessions.md): Every chat is saved under ~/.aster. List, resume, rename, prune, and import from other agents.
- [Permissions](https://docs.withaster.dev/permissions.md): Five permission modes and one rule language that gates every edit, read, and command.
- [Memory](https://docs.withaster.dev/memory.md): Durable memory in two layers. Project facts always in context, named blocks read on demand.

## Extending

- [Skills](https://docs.withaster.dev/skills.md): Folders with a SKILL.md that teach Aster a workflow. Install from GitHub, local dirs, or other agents.
- [Plugins](https://docs.withaster.dev/plugins.md): Agent Plugins packages, skills plus MCP servers, install unchanged.
- [MCP servers](https://docs.withaster.dev/mcp.md): Connect Model Context Protocol servers, local or remote, with progressive injection and per-tool filters.
- [Web](https://docs.withaster.dev/web.md): Search, extract, crawl, sitemaps, and screenshots, as CLI commands and as the agent's web tools.

## Automation

- [Sub-agents](https://docs.withaster.dev/agents.md): Fan work out to named personas with the agent tool, or run them headless with aster run.
- [Schedules](https://docs.withaster.dev/schedules.md): Cron runs, reminders, and where their output goes.
- [Remote control](https://docs.withaster.dev/remote.md): Run Aster over Telegram with long-polling. No public URL, approval prompts as buttons.
- [Goals](https://docs.withaster.dev/goals.md): A slash command that loops turns until a separate judge model agrees the condition is met.

## Workflows

- [Review](https://docs.withaster.dev/review.md): Hypothesize, retrieve evidence, verify by refutation. Findings with file, line, severity, and confidence.
- [Fix](https://docs.withaster.dev/fix.md): Turn review findings into patches, preview them, apply them.

## Surfaces

- [Surfaces](https://docs.withaster.dev/surfaces.md): Terminal, browser, VS Code, Zed, and desktop. One binary, one config.

## Reference

- [Configuration](https://docs.withaster.dev/configuration.md): The complete aster.yaml reference. Precedence, every section, keys, providers, models, and mom.yaml routing.
- [CLI commands](https://docs.withaster.dev/cli.md): Every aster subcommand, with the flags that matter.
- [Environment variables](https://docs.withaster.dev/env.md): Every ASTER_* variable, what it does, and where it sits in the precedence order.
- [Troubleshooting](https://docs.withaster.dev/troubleshooting.md): When something fails: what to run first, and where the logs are.