Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

A general-purpose local agent that runs on anything — from a 2013 Mac Pro trashcan to a PowerBook G4 to an IBM POWER8 mainframe. No cloud, no API keys, no dependencies beyond Python 3.7 and any local LLM server.

**14 tools. 21 commands. Plugin system. Achievements. Zero dependencies.**
**15 tools. 23 commands. Plugin system. Achievements. Zero dependencies.**

## What it does

Expand Down Expand Up @@ -47,7 +47,7 @@ TRASHCLAW_URL=http://your-server:8080 python3 trashclaw.py

No pip install. Single file. Zero dependencies. Python 3.7+ stdlib only.

## Tools (14 built-in + unlimited plugins)
## Tools (15 built-in + unlimited plugins)

| Tool | Description |
|------|-------------|
Expand All @@ -63,10 +63,12 @@ No pip install. Single file. Zero dependencies. Python 3.7+ stdlib only.
| `git_status` | Show modified/staged/untracked files |
| `git_diff` | Show unstaged or staged changes |
| `git_commit` | Stage all changes and commit |

Copy link

Copilot AI Mar 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The blank line inside the Markdown table (between git_commit and clipboard) terminates the table in GitHub-flavored Markdown, causing the following rows (clipboard/think/view_image) to render outside the table. Remove the blank line (or add a new header/separator if you intend to start a second table).

Suggested change

Copilot uses AI. Check for mistakes.
| `clipboard` | Copy/paste from system clipboard |
| `think` | Reason through problems before acting |
| `view_image` | Open an image file for visual analysis |

## Commands (21)
## Commands (23)

| Command | Description |
|---------|-------------|
Expand All @@ -86,8 +88,11 @@ No pip install. Single file. Zero dependencies. Python 3.7+ stdlib only.
| `/sessions` | List saved sessions |
| `/stats` | Show generation stats (tokens, time, tok/s) |
| `/status` | Server, model, context, git branch, stats |

Copy link

Copilot AI Mar 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is an empty line inside the Commands Markdown table (after /status). In GitHub-flavored Markdown this breaks the table and the remaining rows will not render as part of the table. Remove the blank line or repeat the table header for the next section.

Suggested change

Copilot uses AI. Check for mistakes.
| `/undo` | Undo last file write or edit |
| `/achievements` | Show your progress and stats |
| `/image <path>` | Load an image for the next prompt |
| `/screenshot` | Take a screenshot and include in next prompt |
| `/about` | The manifesto |
| `/help` | Full command reference |
| `/exit` | Quit |
Copy link

Copilot AI Mar 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The README now states "Commands (23)", but the CLI also supports /quit (and /q) as exit aliases (see handle_slash in trashclaw.py). Consider documenting these aliases (or adjusting the command count wording) so the list matches the actual command surface area.

Suggested change
| `/exit` | Quit |
| `/exit` (`/quit`, `/q`) | Quit |

Copilot uses AI. Check for mistakes.
Expand Down
Loading