byte-ai-cli 1.4.0
A human-in-the-loop AI coding agent that keeps you in control.
Requires Python: >=3.12

# Byte

<p align="center">
    <img alt="Byte Logo" src="https://raw.githubusercontent.com/usethefork/byte/main/docs/images/assets/logo.svg" /><br />
    <a href="https://github.com/UseTheFork/byte/releases"><img src="https://img.shields.io/github/release/UseTheFork/byte" alt="Latest Release"></a>
</p>

<p align="center">A human-in-the-loop AI coding agent that keeps you in control. Byte helps you build through natural conversation while maintaining full visibility and approval over every change.</a>

<p align="center"><img width="800" alt="Byte Demo" src="https://raw.githubusercontent.com/usethefork/byte/main/docs/images/recording/example_coder.gif" /></p>

---

## What is Byte?

Byte is a CLI coding agent designed for developers who want AI assistance without sacrificing control. Unlike autonomous agents that make multiple decisions and tool calls independently, Byte requires your approval for every decision.

**Key Features:**

- Review and confirm every change before it's applied
- See exactly what the agent modifies in your code
- Manage precisely what information the AI receives
- Slots into your existing development environment
- Structured prompts that adapt and evolve with each interaction
- Automatic linting, formatting, and testing without extra commands

For complete documentation, visit **[usethefork.github.io/byte](https://usethefork.github.io/byte/)**.

---

## Design Philosophy

**Transparency First** - You see the complete prompt, not just your input. All interactions are logged for reference and debugging.

**Explicit Over Implicit** - Changes require approval. Context additions need confirmation. No surprises.

**Complementary, Not Replacement** - Byte enhances your workflow without replacing your tools or editor.

**Quality Over Quantity** - Better prompts produce better results. Byte prioritizes well-structured instructions over large context windows.

---

## Quick Start

See the [Installation Guide](https://usethefork.github.io/byte/getting-started/installation/) for installation methods including uv, pip and Nix.

---

## Why This Approach?

### Human-in-the-Loop Design

Every decision and code change requires your confirmation. If you prefer agents that work autonomously, Byte isn't for you. If you value control and transparency, you'll appreciate the deliberate confirmation flow.

### Built for Experienced Developers

Designed for experienced developers who understand good design principles. This isn't a tool where you provide a specification and it builds the entire feature. Instead, Byte excels at small, incremental changes that keep you in control. Understanding when to refactor, how to structure code, and what constitutes good design remains your responsibility.

### Search/Replace Over Tools

Instead of giving the AI arbitrary tools, explicit Search/Replace blocks show you the exact changes before they happen, making it easy to cancel or modify the proposed work.

### Workflow Preservation

Your editor stays central to development. Whether you use Vim, VS Code, or Jetbrains, Byte complements your existing workflow as something you invoke when needed.

### Context Management

You control exactly what context the LLM receives:

- Add or remove files from the active context
- Monitor token usage and memory consumption
- Prevent context overflow with targeted information

### Intelligent Prompting

Structured prompts adapt with each turn:

- Previous Search/Replace blocks get removed to maintain focus
- Instructions follow clear markdown formatting
- Reduces "tunnel vision" where agents fixate on minor issues
- Full prompt visibility through logging for debugging

### Integrated Tooling

Linting, formatting, and testing run automatically after code changes are applied. Configure your tools once and they work seamlessly in the background without requiring agent interaction.

<!-- ### Controlled MCP Integration

Model Context Protocol (MCP) tools are available but tightly controlled. Manually run tools or restrict which agents can access specific capabilities. -->

---

## Built With

Byte leverages modern Python tooling and AI frameworks:

- **[uv](https://docs.astral.sh/uv/)** - Fast Python package management
- **[LangChain](https://www.langchain.com/)** - AI framework for language models
- **[LangGraph](https://langchain-ai.github.io/langgraph/)** - Graph-based agent workflows
- **[Rich](https://rich.readthedocs.io/)** - Beautiful terminal output
- **[Prompt Toolkit](https://python-prompt-toolkit.readthedocs.io/)** - Interactive command-line interfaces
- **[pydoll](https://pydoll.tech/)** - Browser automation and control
- **[Catppuccin](https://catppuccin.com/)** - Soothing pastel theme

---

## Inspiration

Byte draws inspiration from excellent projects in the coding agent space:

- [Aider](http://aider.chat/) - The pioneering CLI coding agent that proved the concept
- [Charm's Crush](https://github.com/charmbracelet/crush) - Elegant terminal agent