kloop

A terminal coding agent built from scratch in Rust. Describe a task in plain language, and kloop explores your codebase, edits files and runs commands.

What it does

A coding workflow similar to Claude Code, with permissions, resumable sessions, sub-agents, MCP and skills. Supports configurable messages / responses / chat gateways and runs interactively, headlessly or as an agent service.

Install

Requires Rust 1.98+. Primarily tested on macOS; Linux and Windows also build and run. Sandboxing is macOS-only.

make install          # installs to ~/.local/bin

Edit the generated ~/.kloop/config.toml with your provider settings before the first run. Existing configuration is preserved.

Use it

kloop                          # start the TUI; the current directory is the workspace
kloop --mock                   # keyless scripted demo — one run shows you the shape
kloop -c                       # continue the previous session
kloop --headless "fix the flaky test in CI"
kloop --worktree=fix-ci        # work inside an isolated git worktree
kloop --help                   # every flag

Configuration

Configure your provider in ~/.kloop/config.toml:

provider = "my-gateway"

[providers.my-gateway]
wire_api       = "responses"
base_url       = "https://gateway.example.com/v1"
auth_header    = { Authorization = "Bearer ..." }
model          = "deepseek-v4.1-flash"
effort         = "xhigh"
context_window = 1000000

See config/config-demo.toml for all settings.

To replace the built-in base system prompt, add a file path at the top level of ~/.kloop/config.toml, before any [table]:

system_prompt_file = 'system-prompt.md'

Write the prompt directly to ~/.kloop/system-prompt.md as UTF-8 text; no TOML escaping is needed. Relative paths resolve from the config directory; absolute paths are also supported. kloop appends environment information and the opening Git snapshot. Omit this setting to keep the built-in prompt. Startup fails if the file cannot be read, is not valid UTF-8, or is empty or whitespace-only. Restart kloop after edits; resumed sessions also use the updated file.

Community

Share ideas and discuss kloop with the Linux.do community.