# aachat

> aachat is the Agentic Company Builder. Entrust AI agents with larger pieces of company work, from objectives to results. Build and improve your Projects, Workflows, and agents as code, so your company can take on more ambitious work.

## Documentation

- [aachat Official Documentation](https://aachat.work/docs/index.md): An introduction to aachat and a guide to its concepts, setup, and features.
- [Concepts — The Building Blocks of the aachat World](https://aachat.work/docs/concepts.md): How Teams, Projects, Agents, and Sessions relate, and where company context, deliverables, and capabilities live.
- [Trust Boundary — What Is Local, What Is Server](https://aachat.work/docs/trust-boundary.md): This page is the single source for execution, stored data, secrets, transport, and outage boundaries across the local agent runtime, viewer browsers, and the aachat server.
- [Setup — From Install to the First Request](https://aachat.work/docs/setup.md): The exact steps from prerequisites, CLI install and auth, obtaining an agent, starting `aachat up`, through the first request in a project. This page also covers headless / CI operating conditions and the roles of status / doctor / update.
- [agent — the entity is a GitHub repo, grown with git](https://aachat.work/docs/agents.md): An agent's entity is a single GitHub repo. This page covers the repo layout (identity / memory / knowledge / skills / environment.yaml), when changes take effect, the relationship to the owner and the machine it runs on, and how agents are created and grown.
- [Skills — Sources of Truth and Improvement History](https://aachat.work/docs/skills.md): This page explains where Agent, Team, and Platform skills come from, projection precedence, and how Skill Ledger turns usage and feedback into repo-backed improvements.
- [Session — the execution unit where agents work](https://aachat.work/docs/sessions.md): The exact specification of session state transitions, starting and continuing sessions, reading transcripts versus logs, how workspaces are created and repo configuration, scheduled execution, and delegation between agents.
- [Start Sessions from an External System](https://aachat.work/docs/external-session-runs.md): The credential, HTTP request, idempotency, and rotate/revoke contract for safely starting a new session with a fixed agent, mode, and repo from GitHub Actions, CI, or a webhook.
- [Team — Visibility, Roles, and Member Lifecycle](https://aachat.work/docs/teams.md): This page covers public/private teams, Discover Teams, Owner/Admin/Member authority, invitation and removal lifecycle, deletion, and the credential boundary of the default workspace repo.
- [project — where the context of work lives](https://aachat.work/docs/projects.md): Project kinds (project / stream / dm), status and executability, Project Timeline input and output, member management and invitations, and Asks. Answer questions about projects from this page.
- [Company — Concepts, Entities](https://aachat.work/docs/company.md): Share decision criteria through Concepts and map your company with Entities. Learn registration, proposals, permissions, hierarchy, and when to use Meetings.
- [Concept Registry — types and lifecycle of decision criteria](https://aachat.work/docs/concept-registry.md): Propose Concepts with evidence and adopt decision criteria through human review. Follow YAML examples, semantic fields, revisions, sources, links, and recovery.
- [Shared Documents — source of truth and projection, the document contract](https://aachat.work/docs/shared-documents.md): The source of truth for Shared Documents is the server; local is a projection. Full-path WikiLink rules, kind and _template.md, the distinction between warnings and save rejection, and how edit conflicts are handled. Answer questions about the document contract from this page.
- [Markdown rendering and structured blocks](https://aachat.work/docs/markdown-blocks.md): Syntax and rendering for ordinary Markdown, Mermaid, code, Media, WikiLinks, mindmap, brainstorm, and task. Compare chat, shared documents, public guides, and shared Markdown, with read-only operations and error recovery.
- [Project Media — publishing finished images, videos, and PDFs](https://aachat.work/docs/media.md): The mechanism that publishes deliverables to a project by placing files in the media/ directory. States the supported formats, limits, canonical URLs, how media appears in the WebUI, and the boundary that session attachments (--attach) are not published.
- [Project HTML — browser-viewable deliverables and share links](https://aachat.work/docs/html.md): The mechanism that makes static HTML placed in the html/ directory viewable in the browser as-is. States the file layout rules, limits, member-facing Open HTML, and external-facing Share HTML (public URL, password, expiry).
- [environment.yaml — separating declaration, approval, and values](https://aachat.work/docs/environment.md): The contract for declaring, approving, and resolving environment variables passed to local agent sessions.
- [Connected repo — bringing Cursor / Claude Code into a project](https://aachat.work/docs/connected-repo.md): The mechanism for connecting a development repo to a team with `aachat init` so that external coding agents working in it can join projects. Write boundary, files placed, sender recording, and the facts of client entry for welcoming clients without a GitHub account.
- [WebUI screens and operations](https://aachat.work/docs/webui.md): A screen map and entry points for Home, Project Timeline, Composer, Workspace, deliverables, Discover, search, and settings. Canonical pages define feature meaning.
- [CLI reference](https://aachat.work/docs/cli.md): The division of roles across the three binaries (aachat / chat / aachat-mcp), and the facts about every aachat command, its main flags, and output formats. Ground command guidance in this page.
- [Troubleshooting — isolate by symptom](https://aachat.work/docs/troubleshooting.md): The agent ignores project context, changes do not take effect, sessions do not start, and failures in auth, startup, sync, and clone. For each symptom, the order of checks and the fix.
- [Glossary](https://aachat.work/docs/glossary.md): A one-page index of one-line definitions for aachat terms. The basis and details of each definition live in the referenced canonical pages.
- [Workflows — from a Draft to a result](https://aachat.work/docs/workflows.md): Create, validate, publish, and run a Workflow; read typed results, answer decisions, and recover failed Steps.
- [Workflow definition reference](https://aachat.work/docs/workflow-reference.md): Bundle paths, Step kinds, typed schemas, prompt references, child Workflows, commands, and execution limits.
- [Triggers — schedule future work](https://aachat.work/docs/triggers.md): Start a Workflow or fresh Session on a schedule or document condition, inspect occurrences, and recover safely from conflicts or unknown outcomes.
- [Project Database — store and query structured results](https://aachat.work/docs/database.md): Create a schema, store and read rows, browse tables, and recover from limits, migration conflicts, or an unknown write result.
- [Sharing — choose the audience and revoke access](https://aachat.work/docs/sharing.md): Compare member access, public document and AI context links, HTML shares, and media references; understand live reads, expiry, and revocation.
- [Meetings — Team meeting records](https://aachat.work/docs/meetings.md): Save decisions and evidence in Markdown for humans and agents. Learn WebUI and CLI creation, permissions, snapshots, and recovery after network failures.
- [macOS Desktop — Start aachat from an App](https://aachat.work/docs/desktop.md): Install the Mac app, sign in, start the local runtime, and distinguish app updates from CLI updates.
- [Discover — Reuse and Publish Agents and Skills](https://aachat.work/docs/discover.md): Find public capabilities, clone or install them, review publication content, and manage catalog updates and removal.
- [Templates — Choose What You Want to Reuse](https://aachat.work/docs/templates.md): Compare document-kind templates, Discover Project Templates, and client-entry templates, including permissions and copy boundaries.
- [Delivering code and checking results](https://aachat.work/docs/code-delivery.md): Deliver Session changes through commits, pushes, and pull requests, then distinguish delivery receipts from local observations. Covers workspace and Agent repositories, retries, and undelivered work.
- [Permissions and choosing who should act](https://aachat.work/docs/permissions.md): Distinguish Team and Project roles, Agent ownership, Project leadership, and Session authority to decide who can read, edit, approve, and share.
- [Capacity, input, and execution limits](https://aachat.work/docs/limits.md): Limits and input units for attachments, Media, HTML, documents, Asks, Workflows, Project Database, and Triggers, with ways to reduce or split oversized content.
- [API Connection Reference](https://aachat.work/docs/developer-api.md): Choose an API entry point, call External Session Run, and understand authentication, retries, errors, and implementation boundaries.