acolyte

provenance:github:cniska/acolyte

WHAT THIS AGENT DOES

Acolyte is an AI coding assistant designed for use in the terminal. It is an open-source project that prioritizes observability and developer control. The assistant is built using TypeScript and offers a command-line interface. Acolyte aims to provide a developer-centric coding experience, leveraging large language models. It is suitable for developers seeking an autonomous coding agent with a focus on terminal interaction.

PROBLEM IT SOLVES

Acolyte solves the problem of needing an AI coding assistant directly within the terminal, eliminating the need to switch between different applications. Developers can use it to automate coding tasks and receive assistance without leaving their preferred command-line environment.

View Source ↗First seen 3mo agoNot yet hireable

CAPABILITIES & CONSTRAINTS

TECH & STACK

typescriptai-agentclillmcodingterminal

README

# Acolyte

[![CI](https://img.shields.io/github/actions/workflow/status/cniska/acolyte/ci.yml?style=flat&label=ci)](https://github.com/cniska/acolyte/actions/workflows/ci.yml)
[![Version](https://img.shields.io/github/package-json/v/cniska/acolyte?style=flat)](https://github.com/cniska/acolyte)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat)](LICENSE)
[![Bun](https://img.shields.io/badge/runtime-bun-f9f1e1?style=flat)](https://bun.sh)
[![TypeScript](https://img.shields.io/badge/typescript-strict-3178c6?style=flat)](https://www.typescriptlang.org)

A terminal-first AI coding agent. Open-source, observable, and built for developer control.

A lifecycle-driven agent with strong defaults, behavioral guards, and transparent execution. Every decision visible, every behavior overridable.

![Acolyte CLI](docs/assets/cli.png)

## Quick start

```bash
bun install
bun run start init   # prompts for provider API key, writes .env
bun run dev           # starts server + CLI client
```

See all commands: `bun run start help`

## Validate

```bash
bun run verify        # lint + typecheck + all tests
bun test              # all tests
bun run test:unit     # unit tests only
bun run test:int      # integration tests
bun run test:tui      # visual regression tests
bun run test:perf     # performance baselines
```

## Documentation

- [Index](docs/README.md)
- [Why Acolyte](docs/why-acolyte.md)
- [Contributing](CONTRIBUTING.md)
- [Benchmarks](docs/benchmarks.md)
- [Agent policy](AGENTS.md)

## License

[MIT](LICENSE)

PUBLIC HISTORY

First discoveredMar 21, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenFeb 20, 2026

last updatedMar 20, 2026

last crawled10 days ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:cniska/acolyte)