Everyone Will Have an AI Coding Agent

Clawie, a new AI coding agent tool, launches with a packaged workspace combining Rust and Python sides, featuring a Lean Ladder to prevent over-engineering, a REPL with commit and undo commands, SQLite-based vector indexing for semantic search, a Web UI with live log streaming and visual diffing, and a gamified pixel-art dashboard. The tool aims to streamline development by enforcing minimal code practices and providing real-time agent monitoring.

Clawie is a packaged workspace that keeps both sides of the project together: rust-clawie main CLI/runtime side python-clawie Python mirror/workspace side This repository exists so the full project is shareable and runnable from one folder. Configure your environment variables, provider, model, API key, and base URL interactively: ./clawie setup Settings are persisted in settings.json under the Clawie config directory. Clawie enforces a Lean Ladder to prevent over-engineering: Does this need to exist? Is it already in this codebase? Does stdlib do it? Does a native platform feature cover it? Does an installed dependency solve it? Can it be one line? Only then write the minimum code. Manage this mode directly inside the REPL session: /lean lite|full|ultra|off : Switch or view the active lean mode default is full . /lean-review : Review current diff for over-engineering. /lean-audit : Scan repository for over-engineering. /lean-debt : Harvest clawie: simplification comments into a ledger. /lean-gain : Show benchmark impact metrics. /lean-help : Print command reference. Use the /map or /repo-map command in the REPL to generate a ranked map of the repository's files and extracted symbols, helping navigate large codebases. Manage commits directly from the REPL: /commit : Preflight checks changes, generates a commit message, and commits them. /undo : Undoes the last commit soft reset, keeping changes . SQLite-backed vector indexing service for semantic repository searches: Ingest files : cargo run -p claw-rag-service -- ingest --workspace . Serve API & UI : cargo run -p claw-rag-service -- serve Advanced graphical interface features for the local Clawie Web UI: WebSocket Live Log Streaming : Dynamic real-time execution log streams. Rather than pulling static snapshots, the UI connects to a background socket /ws-log to monitor process events as they happen. Side-by-Side Visual Diffing : Compare original files vs agent improvements or current edits. Clicking "Show Diff" provides visual red/green deletions/additions side-by-side with automatic layout alignment. Checks sync and parity between the Rust codebase and Python mirrors: Sync Auditor CLI : ./scripts/check rust python sync.py analyzes command/tool definitions and file parity. Unit Testing : Tests defined in test rust python sync.py run checks in continuous integration. A gamified, real-time pixel-art dashboard showing active agent instances and status: Draggable Agents : CLI processes are rendered as active pixel-art characters in visual rooms complete with desks, computers, bookshelves, and server racks . Session Actions : Terminate active agent sessions directly from the visual interface. State Beacons : Displays process statuses thinking, executing, idle, closed dynamically via color-coded status lights. - Set up the workspace: ./clawie setup - Launch the Clawie agent REPL: ./clawie - Work in these folders depending on focus: rust-clawie for CLI/runtime behavior python-clawie for Python-side mirrored modules and tooling Clawie/ ├── README.md ├── clawie ├── rust-clawie/ └── python-clawie/ The runtime defaults were increased to better support longer sessions: max turns : 64 was lower max budget tokens : 12000 was lower compact after turns : 48 turn-loop --max-turns : default 12 You can tune these at runtime with environment variables: export CLAWIE MAX TURNS=120 export CLAWIE MAX BUDGET TOKENS=30000 export CLAWIE COMPACT AFTER TURNS=80 export CLAWIE STRUCTURED OUTPUT=false export CLAWIE STRUCTURED RETRY LIMIT=2 ./clawie Notes: - Invalid values fall back to defaults. - Numeric values are clamped to at least 1 . Run from repository root. Python-side summary python3 -m python-clawie.src.main summary Run a stateful loop with explicit turn count python3 -m python-clawie.src.main turn-loop "audit this module" --max-turns 30 Resume an existing session python3 -m python-clawie.src.main resume-session <session id "continue" When running complex agent tasks e.g. running a multi-turn audit session with /lean-audit , developers can launch the Web UI alongside their terminal and watch the agent's actions live. Workflow :- Start a CLI session: ./clawie - Open the Web UI by running /webui in the CLI REPL or by running ./clawie --webui - Click on the active room's terminal monitor inside the Web UI dashboard to open the Log Console. - The console connects via WebSocket to /ws-log?pid=<PID and streams process lifecycle updates, command elapsed times, and execution details in real time as the agent runs. - Start a CLI session: When Clawie suggests changes to code files, you can review, edit, and apply them using the side-by-side split screen. Workflow :- Ask Clawie to improve a file: "Optimize main.py" which generates a .improvements.md file . - Open the Web UI and select the file from the workspace explorer sidebar. - Click the "Show Diff" button at the top right of the editor. - Compare the Original File left pane, red deletions and the Improvements / Edited right pane, green additions . - Switch back to the editor with "Show Editor" to make manual refinements, then click "Save" . - Ask Clawie to improve a file: To ensure that CLI runtime command/tool updates inside rust-clawie are mirrored properly inside python-clawie without creating feature drift: Workflow :- Run the sync check CLI tool: ./scripts/check rust python sync.py - The tool outputs a detailed parity report comparing commands in Rust commands.json vs Python's snapshot, and tool specifications in Rust tools/src/lib.rs vs Python's snapshot. - If there are missing files or content drifts, the script exits with code 1 , serving as a validator in Git hooks or CI pipelines. - Run python3 -m unittest python-clawie/tests/test rust python sync.py to assert package structure sync. - Run the sync check CLI tool: Clawie : product name ShrimpAI : parent brand Jameclaw : legacy/origin naming context Earlier working copies were split across multiple local folders. This package keeps everything in one Git-ready structure so onboarding, development, and sharing are simpler.