io.github.xfloukiex-lab/toki-toki
A local causality ledger: records decisions and the reasons, for an agent to recall.
Open source Open in the app JSON README (API)
About
A local causality ledger: records decisions and the reasons, for an agent to recall.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- xfloukiex-lab
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.0
- Last push
- 2026-06-18T19:31:47Z
- Repository state
- ativo
- Language
- Python
- License
- Apache-2.0
- Added
- 2026-08-29 04:01:42
- Updated
- 2026-08-29 04:01:42
- Origin id
io.github.xfloukiex-lab/toki-toki
README
<!-- mcp-name: io.github.xfloukiex-lab/toki-toki -->
# ⏳ Toki Toki no Mi
<img src="icon.png" width="120" align="right" alt="Toki Toki no Mi icon">
An MCP server that remembers **why** each decision was made — a local, searchable decision log.
A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server — one
focused tool you plug into an MCP-compatible client (Claude Desktop, Claude Code,
Cursor, and others).
## What it does
A conversation's context window forgets. A few sessions later, the reasoning
behind an architectural choice is gone, and you re-litigate decisions you already
settled — or quietly reverse them without noticing.
Toki Toki no Mi is a **causality ledger**. It records each decision, the
alternatives you rejected, and why you chose as you did, then lets your assistant
retrieve that history later — and flag a new proposal that contradicts a past
decision.
## Usage
Two tools:
- `log_causality_point` — record a decision, the rejected alternatives, and the justification
- `time_leap_retrieval` — recall past decisions (all of them, or filtered by keyword)
Decisions are stored locally in SQLite under `~/.grandline/` and also mirrored to
a Markdown file, so any external search tool can be pointed at the folder to read
them.
**Tool reference:** `log_causality_point(decision_made, alternatives_rejected, justification)` · `time_leap_retrieval(query: str = "")`
## How it works
**Self-contained, no API key, fully local.** The ledger is a single SQLite file
on your machine with no external dependencies. Nothing is sent anywhere.
## Install
Requires Python 3.10 or newer.
```bash
pip install toki-toki-mcp
```
This installs the `toki-toki` command.
Then register it with your MCP client — either run `claude mcp add toki-toki -- toki-toki`,
or add this to the client's config (e.g. `claude_desktop_config.json`):
```json
{
"mcpServers": {
"toki-toki": { "command": "toki-toki" }
}
}
```
Restart the client and the tool is available.
## The Grand Line stack
Toki Toki no Mi is part of a four-tool set. Each tool stands alone, but installing
all of them unlocks a final surprise via **Laugh Tale**.
| | Package | |
|---|---|---|
| 🗿 | [`road-poneglyph`](https://github.com/xfloukiex-lab/road-poneglyph) | Road Poneglyph |
| ⚔️ | [`conquerors-haki`](https://github.com/xfloukiex-lab/conquerors-haki) | Conqueror's Haki |
| ⏳ | [`toki-toki`](https://github.com/xfloukiex-lab/toki-toki) | Toki Toki no Mi · **← this repo** |
| 🏴☠️ | [`laugh-tale`](https://github.com/xfloukiex-lab/laugh-tale) | Laugh Tale |
## Develop
```bash
git clone https://github.com/xfloukiex-lab/toki-toki
cd toki-toki
python -m venv .venv && . .venv/Scripts/activate # macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
python tests/test_toki_toki.py
```
## Attribution & license
Released under the **Apache-2.0** license. The icon is original artwork
(see `icon.svg`), generated locally; the repository ships no third-party assets.
*This is a fan-inspired project. It is not affiliated with, sponsored by, or
endorsed by the creators or rights holders of* One Piece *(Eiichiro Oda /
Shueisha / Toei Animation). "One Piece" and related names are used only as
thematic flavour and remain the property of their respective owners.*