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
Metadata
Release files for missioncache-db 1.0.36
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| missioncache_db-1.0.36.tar.gz | 299.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| missioncache_db-1.0.36-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 484.2 kB
Release files / missioncache_db-1.0.36.tar.gz
| Download URL | missioncache_db-1.0.36.tar.gz |
|---|---|
| Size | 299.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ae675b333de6bb2045712712e0a69d2aa110436089353b2ad3602cb8e1c78419
|
|
BLAKE2b-256 checksum How to use checksums |
748842268c9d56c0acc39370af820a3f881da176ae8792df0e68e3508cc87f50
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / missioncache_db-1.0.36-py3-none-any.whl
| Download URL | missioncache_db-1.0.36-py3-none-any.whl |
|---|---|
| Size | 185.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d9fd153f429c324f9c3525cfa422e98f886770c46f36b510fa892d6538864f5d
|
|
BLAKE2b-256 checksum How to use checksums |
a289e28559178f1dc2f8a315420db4fa01340ed0771512a6377ea03708ee708f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for missioncache-db 1.0.36
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.