Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Diff Viewer

The /diff command uploads your current git diff and gives you a shareable URL to a syntax-highlighted diff viewer. Review changes from your phone, your desktop browser, or send the link to a teammate.

Using it

Run /diff in a thread or a project channel. Kimaki:
  1. Runs the critique CLI (critique --web) in the working directory.
  2. Uploads the diff and gets back a URL like https://critique.work/v/<id>.
  3. Replies with an embed that links to the diff and shows a preview image.
  /diff ──▶ critique --web ──▶ upload ──▶ https://critique.work/v/<id>
                                              │
                                              ▼
                                 open on phone or desktop
In a session thread, the diff comes from the session's working directory. That is the worktree when the session uses one. In a project channel, it comes from the project folder.
Click the embed to open the full diff viewer in your browser. It works on mobile, so you can review what the agent changed without being at your machine.

From the CLI

The agent (or you) can get the same URL from a terminal:
kimaki session diff --session <session-id>
Inside a session shell --session is optional. The command prints the URL.

Setup

critique is not bundled with Kimaki. Install it once on the machine that runs the bot:
npm i -g critique
The URL is unguessable. Only people you share the link with can see the diff. critique is open source.

Common cases

  • No changes: if the working tree is clean, Kimaki replies No changes to show.
  • Not a git repository: Kimaki replies This project is not a git repository.
  • critique not installed: Kimaki replies with the install command above.

Why this beats raw diff output

A code block in Discord is hard to read on a phone and has no syntax highlighting or file navigation. A diff URL gives you a proper viewer with per-file navigation and highlighting, so you can review a large change on a small screen.