Takopi Commands

Bot commands available in Telegram chat. Implemented as takopi-plugins.

Core fork: /home/ubuntu/takopi/ — local takopi fork with custom features Plugins (edit here): /home/ubuntu/takopi-plugins/takopi_plugins/ Reinstall after changes: ~/reinstall-takopi.sh (auto-bumps version)

/publish

Publishes notes to notes.cherya.boo.

Steps:

1. Analyzing changes — diffs workspace (/home/ubuntu/claude-workspace) against published content (/home/ubuntu/quartz/content), finds added/modified/deleted files
2. Organizing vault — runs Claude agent to prepare vault for publishing (only if changes exist):
   • Updates knowledge-index.md for new notes
   • Validates internal links [[note]]
   • Validates frontmatter (title, tags)
3. Linting & formatting — three batch commands (one process per all files via find -exec {} +):
   • ensure_frontmatter.py — adds/updates frontmatter
   • mdformat — formats markdown
   • markdownlint-cli2 — checks lint errors
   • Excludes .skills/, .claude/, .claude-plugin/ (not vault content)
   • All subprocesses have 120s timeout
4. Syncing files — updates index.md (Latest Changes section), then rsync workspace → quartz content
5. Pushing to GitHub — npx quartz sync (commit + push)
6. Deploying to Cloudflare — waits for Cloudflare Pages deploy to complete (120s timeout)

Telegram output: progress message updates in real-time, final message shows change list with links and agent output.

Source: backend.py → class PublishCommand

/restart

Restarts the Takopi bot.

What it does:

1. Sends ”🔄 Restarting…” message
2. Sends SIGTERM to takopi process (via PID file ~/.takopi/takopi.pid)
3. ~/start-takopi.sh wrapper automatically restarts the process

Source: restart.py → class RestartCommand

/health

Shows bot health status: uptime, engines, projects, MCP servers (real JSON-RPC ping), skills.

Source: health.py → class HealthCommand

---

Technical

• Plugins: takopi-plugins (version auto-bumped by ~/reinstall-takopi.sh)
• Installed via: uv (as takopi dependency)
• Cloudflare Pages project: claude-workspace
• Quartz directory: /home/ubuntu/quartz
• Workspace: /home/ubuntu/claude-workspace
• Site: notes.cherya.boo

See also: Takopi Development | Takopi Setup | Quartz Setup | Cloudflare