# Everyone Will Have an AI Coding Agent

> Source: <https://github.com/HoratiuCode/Clawie>
> Published: 2026-06-27 11:04:39+00:00

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.