# Acai.sh

> A toolkit for spec-driven development.

## Docs

- [Agent Recipes](https://acai.sh/agents.md): Make the most of acai.sh and agentic development by leveraging LLM skills and roles
- [Acai JSON API](https://acai.sh/api.md): Overview of the Acai API and how to access it.
- [List implementation features](https://acai.sh/api-reference/actions/list-implementation-features.md): Return a summary list of Features that are visible to a given Implementation. These features may be defined in specs that were pushed directly to that Implementation, or inherited from a parent Implementation. The response is a summary list of features, containing some metadata and a summary of code…
- [List implementations](https://acai.sh/api-reference/actions/list-implementations.md): Discover which Implementations exist for a Product. Filter by Repo + Branch name, and by Feature name.       This is the orientation endpoint: when you know the current repo and branch, and need to identify the relevant Implementations that track it.
- [Push from branch](https://acai.sh/api-reference/actions/push-from-branch.md): Sync data from your current git branch to the server. - Upload specs (feature.yaml files) and the requirements and metadata defined in them. - Upload code references (ACID tags) found in source code, and their file paths.
- [Read canonical feature context](https://acai.sh/api-reference/actions/read-canonical-feature-context.md): Return the complete context for one feature in one implementation.
- [Write feature states](https://acai.sh/api-reference/actions/write-feature-states.md): Record implementation-specific progress for one feature in one implementation. State writes do not change requirement text or code refs; they only capture how this implementation currently evaluates each requirement, for example assigned, blocked, completed, or accepted. On first write, local state…
- [Blog](https://acai.sh/blog/index.md): Experiments in agentic spec-driven development.
- [Acai.sh CLI](https://acai.sh/cli.md): Overview of the Acai.sh Command Line Interface. The CLI facilitates spec-driven development for humans, AI agents, and CI/CD automations.
- [Acai Dashboard](https://acai.sh/dashboard.md): A shared view of your team's specs, implementation status, and requirement coverage.
- [feature.yaml Specification](https://acai.sh/feature-yaml.md): This is the formal specification for the feature.yaml document format (written as a compliant feature.yaml!)
- [Acai.sh](https://acai.sh/index.md): A toolkit for spec-driven software development. Stop writing prompts, start writing specs. Ship better quality software and minimize slop.
- [Quickstart Tutorial](https://acai.sh/quickstart.md): Write your first feature spec and push it to the Acai.sh dashboard. Equip your LLM agents with the `acai` CLI and teach them to follow a spec-first workflow.
- [Spec-driven Development](https://acai.sh/spec-driven-development.md): Introduction to `feature.yaml` specs, and best practices for spec-first software development.

## OpenAPI Specs

- [openapi](https://acai.sh/openapi.json)

## Optional

- [App (login)](https://app.acai.sh)
- [GitHub](https://github.com/acai-sh/cli)