Task Agent 🤖
A prioritized, file-based task queue for autonomous agentic workers. This system uses a "Mission Control" approach to manage multiple agents working on git-tracked improvements across various branches and worktrees.
📂 System Architecture
The project follows a specific folder structure to manage the lifecycle of an improvement:
docs/issues/: The core queue.mission.usv: A prioritized list of issues using Unit Separator Value (\x1f) format. This serves as the source of truth for task priority.datapackage.json: Frictionless Data metadata for themission.usvschema.pending/: New issues awaiting triage or assignment.draft/: Issues currently being refined or planned.active/: Issues actively being worked on by an agent.completed/{year}/: Successfully implemented and verified improvements.
.gwt/: Git Worktree directory where active branches are checked out for isolated agent execution.
🛠️ Tooling: ta (Task Agent CLI)
The ta tool automates the transition of issues through the queue and manages the underlying git infrastructure.
Commands
| Command | Action |
|---|---|
ta next |
Displays the top prioritized issue from mission.usv. |
ta new |
Creates a new issue file and adds it to the queue. |
ta done |
Moves issue to completed/, removes it from the queue, and auto-commits the result. |
ta start <slug> |
Moves issue to active/, creates a git branch, and sets up a .gwt/ worktree. |
ta run <slug> |
Invokes the sidecar worker defined at .ta/worker to process an active issue. |
🚀 Workflow
- Prioritize: Use
ta new -t "Title"to add a task. - Review: Run
ta nextto see what is currently at the top of the queue. - Dispatch: (Planned) Run
ta start <slug>to prepare the workspace. - Execute: (Planned) The agent (Gemini CLI) processes the task in its isolated worktree via
ta run <slug>. - Finalize: Once verified,
ta donemoves the task to the finished state.
🤖 Multi-Agent CLI Portfolio (multi-agent-registry)
task-agent integrates with multi-agent-registry (multi_agent_registry) to automatically detect, configure, and inspect AI agent CLIs across your developer workstation:
- Supported Agent CLIs: Claude Code (
claude), Antigravity CLI (agy), OpenCode (opencode), Grok Build (grok), GitHub Copilot CLI (copilot), Cursor (cursor), Windsurf (windsurf), Aider (aider), Continue (continue), Cline (cline), Roo Code (roo). - Features: Automatic CLI detection, MCP configuration generation (
ta init-mcp), session discovery, recent agent activity tracking (ta agent recent), and plugin management.
💬 Matrix Messaging Integration & Sidecar Daemon
task-agent includes a zero-dependency Matrix sidecar bridge daemon (sidecars/matrix-bridge/) for real-time remote notification and task chat bridging:
- Global Space & Store Binding:
# Configure machine-wide Matrix Space link ta store matrix space set 'https://matrix.to/#/!space_id:matrix.org' # Configure secret token reference (1Password op://, Linux keyring secret-tool://, or pass://) ta store matrix token set 'op://Private/6pcab3dt5sml3sslfh6xffqit4/Saved on account.matrix.org/access-token'
- Automated Space & Child Room Provisioning:
When launched, the sidecar daemon (
python3 sidecars/matrix-bridge/matrix_bridge.py) auto-discovers or provisions unencrypted child rooms inside your Space for each repository store and delivers real-time inbox comments.
1 maintainer
Metadata
1 maintainer
Release files for task-agent 1.3.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| task_agent-1.3.8.tar.gz | 877.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| task_agent-1.3.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / task_agent-1.3.8.tar.gz
| Download URL | task_agent-1.3.8.tar.gz |
|---|---|
| Size | 877.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4a9ec671c3e2b1ab8d9bc9377b67fb8783282517f4de960f0caa606bc12f8cae
|
|
BLAKE2b-256 checksum How to use checksums |
3b2d66e180b1ec1a7b54fc0963825f2fe00c7fd05ad99c8ffb4693f52048b4a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / task_agent-1.3.8-py3-none-any.whl
| Download URL | task_agent-1.3.8-py3-none-any.whl |
|---|---|
| Size | 177.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5ab2d9a74d6f17ac7213fbd93a1e2f810d91481317cc297af124597e9d10d38b
|
|
BLAKE2b-256 checksum How to use checksums |
233be82cbb2e1d475996d5335711443b7d2ee34651e6c05c54beeb3ca9b7b58d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency log
