https://github.com/lex00/chant
Task automation system with AI-powered execution. Declarative task definitions, automatic dependency handling, and LLM-driven implementation.
https://github.com/lex00/chant
ai cli llm rust task-automation
Last synced: 4 months ago
JSON representation
Task automation system with AI-powered execution. Declarative task definitions, automatic dependency handling, and LLM-driven implementation.
- Host: GitHub
- URL: https://github.com/lex00/chant
- Owner: lex00
- License: apache-2.0
- Created: 2026-01-24T17:36:22.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-05T04:20:18.000Z (4 months ago)
- Last Synced: 2026-02-05T14:13:37.915Z (4 months ago)
- Topics: ai, cli, llm, rust, task-automation
- Language: Rust
- Homepage: https://lex00.github.io/chant
- Size: 4.81 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Notice: NOTICE
Awesome Lists containing this project
README
# Chant
**Idempotent Intention**
[](https://github.com/lex00/chant/actions/workflows/ci.yml)
[](https://github.com/lex00/chant/actions/workflows/release.yml)
[](https://codecov.io/gh/lex00/chant)
[](https://opensource.org/licenses/Apache-2.0)
[](https://github.com/lex00/chant/releases/latest)
[](https://lex00.github.io/chant/api/chant/)
Chant is a spec execution platform for AI-assisted development. Specs are markdown files that agents execute.
## Installation
See the [Installation Guide](https://lex00.github.io/chant/getting-started/installation.html) for detailed platform-specific instructions.
## Documentation
Full documentation is available at **[lex00.github.io/chant](https://lex00.github.io/chant)**
To build and preview docs locally:
```bash
just docs-serve
```
## Quick Start
**1. Initialize your project:**
```bash
chant init
```
**2. Create a spec:**
```bash
chant add "Add user authentication"
```
**3. Execute the spec:**
```bash
chant work 001
```
For detailed setup instructions, see the [Quick Start Guide](https://lex00.github.io/chant/getting-started/quickstart.html).
## Core Concepts
- **Specs** - Markdown files with YAML frontmatter describing work to be done
- **Execution** - Agents implement specs following acceptance criteria
- **Verification** - Continuous checking that work meets intent
- **Drift Detection** - Know when reality diverges from specs
## Key Features
- **Parallel execution** - Run multiple specs concurrently with isolated worktrees
- **Chain execution** - Process specs sequentially (`chant work --chain`) or chain through specific IDs
- **Approval workflow** - Gate spec execution with human approval, auto-detect agent-assisted work
- **Branch mode** - Execute specs in feature branches with automatic merge
## Examples
See the [examples/](./examples/) folder for real-world workflows.
## Development
```bash
# Build the binary
just build
# Run tests
just test
# Build and serve docs
just docs-serve
```
## License
Apache-2.0. See [LICENSE](LICENSE) for details.