Token Harbor

---
name: token-harbor
description: "Open Token Harbor, report stored Sail Power and harbor progress, or help the user configure local Codex token tracking."
category: ai-agents-and-harness
source_repo: hashgraph-online/awesome-codex-plugins
source_path: "plugins/NickHOI/Token-Harbor/skills/token-harbor/SKILL.md"
source_url: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/NickHOI/Token-Harbor/skills/token-harbor/SKILL.md
---


# Token Harbor

Use the bundled `token-harbor` MCP tools whenever the user asks to open the harbor, check Sail Power, inspect port progress, or troubleshoot the companion game.

## Main workflow

1. Call `open_harbor` when the user wants to play or see the harbor.
2. Return the local URL as a clickable link. Do not narrate token usage after every Codex response.
3. Call `harbor_status` for a concise progress summary when a full game view is unnecessary.
4. Treat the harbor as one global world shared by every Codex project.

## Privacy

- Token Harbor stores numeric usage totals and game state locally under `PLUGIN_DATA`.
- It must not collect raw prompts, assistant text, file contents, or tool output.
- Token telemetry is opt-in. Keep `otel.log_user_prompt = false` when helping with configuration.

## Attention handoff

The game may be active while Codex works. When a task needs approval or finishes, the harbor pauses its active voyage and highlights the task status so the user can return to Codex immediately.

---

**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/NickHOI/Token-Harbor/skills/token-harbor/SKILL.md`