Skip to main content

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 the mission.usv schema.
    • 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

  1. Prioritize: Use ta new -t "Title" to add a task.
  2. Review: Run ta next to see what is currently at the top of the queue.
  3. Dispatch: (Planned) Run ta start <slug> to prepare the workspace.
  4. Execute: (Planned) The agent (Gemini CLI) processes the task in its isolated worktree via ta run <slug>.
  5. Finalize: Once verified, ta done moves 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.

Metadata

Release files for task-agent 1.3.12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for task-agent 1.3.12
File Size Uploaded Provenance Actions
task_agent-1.3.12.tar.gz 907.0 kB With provenance Details for task_agent-1.3.12.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for task-agent 1.3.12
File Interpreter ABI Platform Actions
task_agent-1.3.12-py3-none-any.whl Python 3 none any Details for task_agent-1.3.12-py3-none-any.whl

Total release size: 1.1 MB

Release files / task_agent-1.3.12.tar.gz

Download URL task_agent-1.3.12.tar.gz
Size 907.0 kB
Tags Source
SHA-256 checksum
How to use checksums
c6d7c703b43c75646d10f15f24c5171c5072021d441fd627051096189e0794a4
BLAKE2b-256 checksum
How to use checksums
36e9ade105a8ef8a8dfd45e9d6a99eee1c020d46f177051a1456bd2614317585
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 8, 2026.

Transparency log

Release files / task_agent-1.3.12-py3-none-any.whl

Download URL task_agent-1.3.12-py3-none-any.whl
Size 195.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b67501ffa3a79684491b2b1344b384b5b9d8266cc18a049e3a2e03cf339dce03
BLAKE2b-256 checksum
How to use checksums
a7c6c15e70f43bc6cb75042fdbaa424336e02c97ae955a175c28992c05b07aa4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 8, 2026.

Transparency log

Security for task-agent 1.3.12

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for task_agent-1.3.12.tar.gz

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 Nov 8, 2026.

Transparency log

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.3.12 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page