https://github.com/uname-n/pit
a lightweight issue tracking mcp tool
https://github.com/uname-n/pit
claude-code mcp
Last synced: 2 months ago
JSON representation
a lightweight issue tracking mcp tool
- Host: GitHub
- URL: https://github.com/uname-n/pit
- Owner: uname-n
- Created: 2026-04-06T01:11:00.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-04-06T01:22:28.000Z (3 months ago)
- Last Synced: 2026-04-06T03:21:54.860Z (3 months ago)
- Topics: claude-code, mcp
- Language: Rust
- Homepage:
- Size: 40 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
pit
local issue tracker MCP server — one binary, one SQLite file.
---
**pit** is a lightweight issue tracker that runs as an [MCP](https://modelcontextprotocol.io) server. It stores everything in a single SQLite database, so there's nothing to configure and no external services to manage.
Built for use with [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and other MCP-compatible clients.
## Features
- **Single binary, single file** — no setup, no accounts, no network dependency
- **Full-text search** — powered by SQLite FTS5
- **Labels** — auto-created on first use
- **Comments** — threaded context on any issue
- **Issue lifecycle** — `open` → `in-progress` → `closed`
- **Kanban TUI** — live read-only board via `pit kanban`
- **Dashboard** — split-screen claude + kanban via `pit dashboard` ([screenshot](docs/dashboard.png), requires tmux)
## Install
```bash
curl -fsSL https://raw.githubusercontent.com/uname-n/pit/master/install.sh | sh
```
## Setup
```bash
claude mcp add pit -- pit
```
Or add pit to your project's `.mcp.json`:
```json
{
"mcpServers": {
"pit": {
"command": "pit"
}
}
}
```
pit will create a `.pit/db.sqlite` file in your working directory. To use a custom path, set the `PIT_DB` environment variable.
## Usage
```bash
pit # run as MCP server on stdio
pit kanban # live read-only kanban board (TUI)
pit dashboard # tmux split: claude (top) + kanban (bottom)
pit --help # show all commands
```
## Tools
| Tool | Description |
|---|---|
| `pit_create_issue` | Create a new issue with optional body, labels, and status |
| `pit_list_issues` | List issues with filtering by status/labels, sorting, and pagination |
| `pit_get_issue` | Get a single issue with all its comments |
| `pit_update_issue` | Update title, body, status, labels, or close reason |
| `pit_add_comment` | Add a comment to an issue |
| `pit_search_issues` | Full-text search across titles, bodies, and comments |
| `pit_list_labels` | List all labels with issue counts |
| `pit_delete_issue` | Delete an issue and its comments |