thymercli

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 11 Open GitHub ↗

MCP server and CLI for Thymer: connect AI agents and your terminal to your workspaces

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# thymercli

A companion app for [Thymer](https://thymer.com) that provides an MCP server for connecting AI agents and a command-line interface for direct workspace access.

See [thymer.com/mcp](https://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](https://modelcontextprotocol.io/)
- **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

```bash
go build -o thymercli .
```

## Quick start

```bash
# 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`.

```bash
# 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 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:

```bash
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](https://thymer.com/mcp)
- [Support](https://thymer.com/support)

thymercli

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

thymercli

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README