thymercli

A companion app for Thymer that provides an MCP server for connecting AI agents and a command-line interface for direct workspace access.

See thymer.com/mcp for full documentation, setup instructions, and downloads.

Features

• MCP Server — Exposes your Thymer workspaces to AI agents (Claude Code, Cursor, Gemini CLI, etc.) via the Model Context Protocol
• CLI — Manage workspaces, collections, pages, journal, plugins, themes, and more from the terminal
• Interactive REPL — Run commands interactively while the MCP server runs in the background
• Markdown Mirror — Continuously export workspaces as markdown files to a local directory for grepping and reading

How it works

┌─────────────┐       HTTP/JSON-RPC        ┌─────────────┐      WebSocket       ┌─────────────┐
│  AI Agent   │ ◄─────────────────────────►│ thymercli   │◄────────────────────►│   Thymer    │
│ (Claude)    │      MCP Protocol          │  (Go app)   │◄────────────────────►│  Org 1...N  │
└─────────────┘                            └─────────────┘                      └─────────────┘

thymercli runs locally on your machine. It connects to Thymer in your browser (or the upcoming desktop app) via WebSocket, and serves MCP over HTTP on 127.0.0.1:13100. Your data never leaves your machine for MCP — it flows directly between Thymer, the local CLI, and your AI agent.

Multiple Thymer organizations can connect simultaneously (e.g., personal.thymer.com and work.thymer.com).

Building

go build -o thymercli .

Quick start

# Start the MCP server and interactive REPL
./thymercli

Then connect Thymer via the MCP Settings dialog (statusbar or Command Palette), and point your AI agent to http://127.0.0.1:13100.

# Or use CLI commands directly
./thymercli search "meeting notes"
./thymercli journal
./thymercli page list -w "My Workspace" -c "Tasks"

CLI commands

thymercli                          Start MCP server & interactive REPL
thymercli mcp                      Start MCP server explicitly
thymercli status                   Show server status and connected organizations

thymercli workspace list           List available workspaces
thymercli workspace show           Show workspace details

thymercli collection list|show|create|trash|navigate
thymercli page list|show|create|insert|add|move|trash|untrash|navigate
thymercli line edit|delete|move|flag|done
thymercli property list|get|set
thymercli journal [date]           Show or add to journal pages
thymercli search <query>           Full-text search across a workspace
thymercli plugin list|show|update
thymercli theme list|get|set

thymercli mdmirror                 Trigger markdown mirror update
thymercli use                      Set persistent workspace/collection context

Use --json for structured output, --workspace/--collection to scope commands, and pipe content via stdin:

cat notes.md | thymercli page add PAGE_GUID
cat styles.css | thymercli plugin update css PLUGIN_GUID
echo "Shipped v2.0" | thymercli journal add

MCP access

MCP access is opt-in and disabled by default. Each workspace can be set to Off, Read Only, or Read & Write from the MCP Settings dialog in Thymer.

More information

• Full documentation & setup guide
• Support