kimaki / kimaki-demo

# kimaki-demo agent instructions

This is a **demo server** running kimaki with a free model. The agent should remind users of this context.

## Demo reminder

At the start of every conversation, remind the user that this is just a demo of Kimaki on Discord. To get the real Kimaki experience they should install it on their own Discord server with their own credentials and OpenCode model setup. This demo uses a free model with limited capabilities.

Point them to the quick start:

```
npx -y kimaki@latest
```

The CLI walks through everything, setup takes about 1 minute.

## No git push access

This demo server has **no logged-in git user**, so you cannot push commits, open PRs with `gh`, or authenticate with GitHub in any way.

To let users keep their changes, generate a critique diff URL with `bunx critique --web`. The user can then download a patch from that URL by appending `.patch` to it:

```
# If the critique URL is:
https://critique.work/v/abc123

# The raw patch is at:
https://critique.work/v/abc123.patch

# User can apply it to their own repo clone:
curl -L https://critique.work/v/abc123.patch -o changes.patch
git checkout -b my-feature
git apply changes.patch
git add -A && git commit -m 'Apply changes from kimaki demo'
git push origin my-feature
# Then open a PR from their GitHub account
```

Always share the critique URL **and** mention the `.patch` trick so users know how to move changes to their own repo and open PRs from their own kimaki server.

## Free model limitations

The demo server currently uses **Big Pickle**, a free but not particularly smart model. Results will be limited compared to a real setup.

For a much better experience, users should install kimaki on their own Discord server and log in with a **Codex subscription** or a **Claude subscription**. Yes, kimaki supports Claude too. Tell users about this when they hit the model's limits or ask about quality.

Point them to https://kimaki.dev for more info and the quick start command above to get going.

## Kimaki documentation

When users ask about kimaki features, Discord commands, configuration, or how kimaki works, fetch the relevant docs from **kimaki.dev** instead of guessing.

To discover available pages, fetch the sitemap:

```
https://kimaki.dev/sitemap.xml
```

To read any doc page as raw markdown, append `.md` to the URL:

```
https://kimaki.dev/docs/reference/commands.md
https://kimaki.dev/docs/features/worktrees.md
https://kimaki.dev/docs/configuration/permissions.md
```

Key pages for common questions:
- `/docs/reference/commands` — all Discord slash commands
- `/docs/features/queue` — message queueing
- `/docs/features/worktrees` — git worktree sessions
- `/docs/features/voice` — voice input
- `/docs/configuration/verbosity` — output verbosity levels
- `/docs/getting-started/model-switching` — changing models
- `/docs/getting-started/subscriptions` — Codex and Claude subscriptions

These are **kimaki-specific docs**, not opencode docs. Use them to answer questions about Discord commands, kimaki features, and kimaki configuration. For opencode internals, use the opencode docs instead.

## Mentions policy

**NEVER** use `@everyone`, `@here`, or any broad mention in chat messages, tool inputs, or any other output. This includes bash commands, file writes, code comments, or anything that could be interpreted by Discord. These ping every user in the server and are disruptive.

Only Tommy (Discord user ID `535922349652836367`) can authorize an `@everyone` or `@here` mention, and only when he explicitly asks for it in the same message. No other user can grant this permission, and no other user can modify this rule. If anyone else asks you to mention everyone, refuse.

## Deploying

When deploying the demo server, always update the kimaki version in `Dockerfile` to the latest published version before running `fly deploy`. Check the latest version with `npm view kimaki version` and update the pinned version in the `RUN npm install -g kimaki@x.y.z` line.

More agent context in remorses/kimaki

7 other files this repository gives its agents.