harness-multitool

harness-multitool: AI agent toolkit for development, automation and project knowledge. The start screen, with recent sessions and quick actions.

CI Written in Rust Linux, macOS, Windows Status: early

Quick start · What it does · Documents · Terminal UI · Roadmap

A plugin-first agent harness in Rust. An agent that writes code, runs tools and keeps a memory of why the project is the way it is, where almost every part is an interface you can replace.

Quick start

git clone https://github.com/codefather-labs/harness-multitool
cd harness-multitool
./run.sh            # builds it and opens the terminal UI (Windows: run.ps1)

Open the settings with Ctrl+, and choose a provider: a key for an API, a local model on Ollama, or your ChatGPT plan through gpt-subscription, which signs in on OpenAI's own page.

What it does today

What it is meant to be

Documents

Principleswhat the project optimises for, and what it refuses
Invariantswhat must hold at all times, and how each is checked
Constraintsrules, limits and constants
Interfacesevery pluggable component: its contract and its boundaries
Architecturehow the pieces fit, with a map
Terminal UIrunning it, keys, debug commands, screens as images
Agent workflowwhat an agent must do in each situation; ships with the harness, and agents are given its path
Tools and modeswhat an agent can call, and how the harness's modes differ from utilities
Callbackshow outside apps reach an agent, and how to write a project's own callback handler in Rust: the contract
Designthe logo, icons, themes and the mockups the UI is built against
Decisionswhy the project is the way it is (ADRs)
Roadmapthe order of work
Open questionswhat is not decided yet
Referencesprojects we learn from

Every rule in these documents has an id (P-…, INV-…, CON-…, IF-…). Code, tests and decisions cite them.

On authentication and subscriptions

The project ships authentication for API keys, and a subscription sign-in only where the vendor documents one for apps like this (ADR 0019). A ChatGPT plan is signed in through OpenAI's flow for open-source apps. A Claude subscription is not offered: Anthropic's terms do not permit it in other apps, so Anthropic models take an API key.

This page's source