Open source

LightAgent

A small terminal coding agent that keeps its state in a local file

BetaRustMIT

About

LightAgent is a small terminal coding agent written in Rust. It asks a language model for the next action, runs a shell command, writes or reads a file, and records every step in a local .agent/state.jsonl file. A task can be continued with resume. It uses local Ollama by default, or OpenAI or Anthropic when an API key is set. It runs commands without a sandbox and has not been tested with real models yet, so it is in beta.

Features

Records every step in .agent/state.jsonl and continues with resume
Warns about git commit drift on resume
Asks for confirmation before commands and file writes by default, --yolo runs without asking
Ollama (default), OpenAI and Anthropic providers
At most 15 steps per run

Requirements

A recent stable Rust toolchain to build from source (verified with 1.96); a running Ollama or an OpenAI or Anthropic API key

Install

cargo install --git https://github.com/Ankara-Software/lightagent

Prebuilt binaries for Windows, macOS, Linux

Usage

lightagent start "Fix the failing test in tests/auth.rs"

lightagent status

lightagent resume --yolo

Want to contribute?

Bug reports and pull requests are handled on GitHub.

Report an issue All projects