# Claurst — Agentic Coding Harness Built in Rust

> A terminal-based agentic coding tool built in Rust that provides a fast, resource-efficient alternative to heavier coding agent frameworks. Designed for developers who want a lightweight harness for AI-assisted development.

## Install

Save as a script file and run:

# Claurst — Agentic Coding Harness Built in Rust

## Quick Use
```bash
git clone https://github.com/Kuberwastaken/claurst.git
cd claurst
cargo install --path .
claurst init
```

## Introduction
Claurst is a coding agent harness written in Rust that provides a streamlined, fast interface for AI-assisted development. It focuses on being a practical tool for builders who want to ship code quickly with AI help, without the overhead of heavier frameworks or complex setup.

## What Claurst Does
- Provides an interactive TUI for conversing with AI models about code
- Reads and writes files in your project directory based on model instructions
- Supports multiple LLM providers including Claude, OpenAI, and Gemini
- Offers a session system for organizing work across tasks
- Ships as a single binary with no runtime dependencies

## Architecture Overview
Claurst is a monolithic Rust binary containing a TUI renderer, an LLM client layer, and a file operations module. The TUI is built with the ink-inspired rendering approach for responsive terminal output. The LLM client supports tool use for file read, write, search, and shell command execution. Session state is persisted to disk as JSON.

## Self-Hosting & Configuration
- Install via cargo install from source or download a release binary
- Configure API keys for your preferred LLM provider in ~/.claurst/config.toml
- Set default model, temperature, and context window preferences
- Project-specific settings can be placed in .claurst.toml at the repo root
- Supports environment variables for all configuration options

## Key Features
- Single Rust binary with instant startup and low memory footprint
- Multi-provider support for Claude, OpenAI, Gemini, and DeepSeek
- Built-in TUI with syntax highlighting and markdown rendering
- Session management for organizing multi-step coding tasks
- File and shell tool use for autonomous code modifications

## Comparison with Similar Tools
- **Claude Code** — feature-rich but requires Node.js runtime; Claurst is a single Rust binary
- **CodeWhale** — focuses on open-weight models; Claurst supports both cloud and local providers
- **Aider** — Python-based with git integration; Claurst is Rust-native with session management
- **OpenCode** — Go-based agent; Claurst provides a similar experience in Rust

## FAQ
**Q: Why Rust instead of TypeScript or Python?**
A: Rust provides instant startup, low memory usage, and a single self-contained binary without runtime dependencies.

**Q: Can I use local models?**
A: Yes, point the configuration at any OpenAI-compatible endpoint such as Ollama or llama.cpp.

**Q: Does it support git integration?**
A: Claurst can execute git commands via its shell tool, but does not have built-in git commit workflows.

**Q: What platforms are supported?**
A: Linux, macOS, and Windows. Pre-built binaries are available for all three.

## Sources
- https://github.com/Kuberwastaken/claurst

---
Source: https://tokrepo.com/en/workflows/asset-d7af86e2
Author: Script Depot