missioncache-db
SQLite-based task and time tracking database for the MissionCache Claude Code plugin.
Provides cross-repo task tracking with WakaTime-style heartbeat time aggregation. Used as the storage layer for the MissionCache MCP server, hooks, CLI, and dashboard, but it's a standalone library and can be used on its own.
Install
pip install missioncache-db
Use as a library
from missioncache_db import TaskDB
db = TaskDB() # defaults to ~/.missioncache/tasks.db, override via TaskDB(db_path=...)
repo_id = db.add_repo("/path/to/repo")
task = db.create_task(name="my-task", repo_id=repo_id)
db.record_heartbeat(task_id=task.id, directory="/path/to/repo")
Use as a CLI
missioncache-db list-active
missioncache-db heartbeat-auto
missioncache-db task-time <task_id>
missioncache-db set-category <task_id> <category|none>
missioncache-db --help
Storage
All state lives in a single SQLite database at ~/.missioncache/tasks.db
(override by passing db_path to TaskDB). The database is WAL-mode,
auto-initializes on first access, and is safe for concurrent readers.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file missioncache_db-1.0.19.tar.gz.
File metadata
- Download URL: missioncache_db-1.0.19.tar.gz
- Upload date:
- Size: 181.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e9b06f374fd1a8728fb447394dca3bd5b7318b2c901f0f4cfa2326a74fd0a1aa
|
|
| MD5 |
378e7747f4aaff335505812c97e5bbbd
|
|
| BLAKE2b-256 |
e25b1151b0fc2da55fb750f5121ac6d7f73f2a723c95d09d7c7319129825862e
|
File details
Details for the file missioncache_db-1.0.19-py3-none-any.whl.
File metadata
- Download URL: missioncache_db-1.0.19-py3-none-any.whl
- Upload date:
- Size: 109.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bbdc91a9981eb069911911bff8a7b715e7080c8aaeea88ebe20547e2152c35be
|
|
| MD5 |
2c73cd19e55a47fbc758fbed37142340
|
|
| BLAKE2b-256 |
a9833683b583d3abd713d014c991ecb1ab4cf5efa3c3ebd54afaa4d86474cc9e
|
