axe

A lightweight cli for running single-purpose AI agents. Define focused agents in TOML, trigger them from anywhere; pipes, git hooks, cron, or the terminal.

What is axe?

A lightweight cli for running single-purpose AI agents. Define focused agents in TOML, trigger them from anywhere; pipes, git hooks, cron, or the terminal.

Overview of axe

What it is

Axe is a lightweight CLI tool for running single-purpose AI agents powered by large language models. Agents are defined in TOML configuration files, each with its own system prompt, model selection, skill files, context files, working directory, persistent memory, and the ability to delegate to sub-agents. Axe is designed to be composed with standard Unix tools — pipes, git hooks, cron, CI — rather than acting as a scheduler or workflow orchestrator.

Key features

  • Multi-provider support: Anthropic, OpenAI, Ollama (local models), OpenCode, and AWS Bedrock - TOML-based agent configuration: declarative, version-controllable agent definitions - Sub-agent delegation: agents can call other agents via LLM tool use, with depth limiting and parallel execution - Persistent memory: timestamped markdown logs that carry context across runs; includes LLM-assisted memory garbage collection - Stdin piping: pipe any output directly into an agent (e.g., git diff | axe run reviewer)
  • Built-in tools: file operations sandboxed to working directory, shell command execution, URL fetching, web search with output allowlist and SSRF protection - Minimal dependencies: four direct dependencies (cobra, toml, mcp-go-sdk, x/net); all LLM calls use the standard library

Use cases

  • Code review: pipe a git diff into a reviewer agent - Log analysis: pipe error logs into a log-analyzer agent - Commit message generation: pipe staged changes into a commit message agent - Text summarization: run a summarizer agent on any text input - Chaining agents together via pipes or sub-agent delegation - Triggering agents from cron, git hooks, or CI pipelines

Getting started

bash go install github.com/jrswab/axe@latest # or build from source: git clone https://github.com/jrswab/axe.git cd axe go build . # Initialize configuration axe config init # Scaffold a new agent axe agents init my-agent # Run the agent axe run my-agent

License and pricing

Licensed under Apache-2.0. Open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/jrswabaxe.svg)](https://yunodb.com/tools/jrswabaxe?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/jrswabaxe?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/jrswabaxe.svg" alt="Featured on YunoDB" height="20"></a>