# CLAUDE.md — Kanboard

Guidance for Claude Code when working with the Kanboard service on the Agap server.

This directory holds only the **live** Docker Compose config for the `kanboard`
container (board data lives in a Docker volume). Everything else Kanboard-related —
service docs, the task-orchestration ruleset, the `claude-usage` quota script, and a
reference copy of the `kanboard_*` MCP tool implementation — has been consolidated into
its own repo: **`/home/alvis/kanboard`** (Gitea: `alvis/kanboard`). Read
`/home/alvis/kanboard/CLAUDE.md` before working with Kanboard or the orchestration
pipeline.

- Container `kanboard`, image `kanboard/kanboard:latest`, port `127.0.0.1:4800:80`
- The MCP server implementing `mcp__agap__kanboard_*` (`src/kanboard.js`) lives in
  `agap-mcp` (`/home/alvis/agap_git/agap-mcp`) — shared with other tool sets (`vw_*`,
  `gitea_*`, `ha_*`, `zabbix_*`, `radicale_*`), so it stays here rather than moving to
  the kanboard repo.

## Common Commands

```bash
docker compose up -d       # start
docker compose restart     # restart
docker compose logs -f     # logs
```