# Bassfish

> A local coordination layer for coding agents working in the same Git repository and its worktrees.

Bassfish provides shared threads, owned tickets with dependencies, advisory file reservations, durable content-bearing notifications, host-session identity binding, and actionable-work listening through MCP Tasks. Its agent-facing MCP surface has 13 tools and opaque request and turn tokens. History, restore, project operations, and daemon management use the human CLI. File contents remain in the repository and are edited with native tools. Install the npm package `@bassfish/cli`, run `bassfish setup`, and install the native host plugin or connect another MCP host to `bassfish mcp`.

Requires Node.js >=24.12.0 <25, Git, and macOS or Linux on arm64 or x64. Read the installation section before installing or calling tools.

## Documentation

- [Install Bassfish](https://tfukaza.github.io/bassfish/index.md#install-it): Concise commands for the latest CLI/MCP package, Codex, Claude Code, OpenCode, agent-targeted skills, verification, and upgrades.
- [Agent skills](https://github.com/tfukaza/bassfish/tree/main/.agents/skills): `use-bassfish` provides coordination guidance and `manage-bassfish` covers installation and operations. Install both for the chosen host; an MCP connection is still required.
- [Browsable documentation](https://tfukaza.github.io/bassfish/docs.html): Host configuration, verification, thread, ticket, notification, file-lock, upgrade, and troubleshooting guidance.
- [Website as Markdown](https://tfukaza.github.io/bassfish/index.md): A text overview with installation commands.
- [Source and README](https://github.com/tfukaza/bassfish): Implementation and current project documentation.
- [MCP tool schemas](https://github.com/tfukaza/bassfish/blob/main/src/mcp-api.ts): Public source definitions; the connected server's live schemas are authoritative for installed versions.
- [Host compatibility](https://github.com/tfukaza/bassfish/blob/main/docs/compatibility.md): Host setup and qualification status.