Taskforce

Taskforce is a shared task and planning workspace for humans collaborating with AI.

It brings tasks, planning, document review, image review, and AI access into one place so people and AI collaborators can work from the same source of truth.

Taskforce is currently in beta and under active development.

Install Taskforce

Install Taskforce once, then run it from any folder, workspace, or project:

npm install --global @taskforcehq/taskforce

Then open Taskforce from the folder, workspace, or project you want to manage:

taskforce open

You can also install with Homebrew:

brew tap taskforcehq/tap
brew install taskforce

The npm package page may show npm i @taskforcehq/taskforce, but most users should include --global so the taskforce command is available from the terminal.

Update Taskforce

If you installed with npm:

npm update --global @taskforcehq/taskforce

If you installed with Homebrew:

brew upgrade taskforce

Get Started

Go to the folder you want Taskforce to manage, then run:

taskforce open

Taskforce opens in your browser and stores workspace data in that folder, under .taskforce/.

Updating or uninstalling Taskforce does not remove your workspace data.

To confirm which workspace Taskforce is using:

taskforce status

To connect a local AI client through MCP, start the MCP server from the same workspace:

taskforce mcp

What Taskforce Includes

Task Management

• Tasks with title, description, status, priority, type, category, assignee, due date, scheduled date, and checklist support
• Custom workspace taxonomy for categories, types, priorities, approaches, and complexity
• Task comments and task attachments
• Schedule board for planning work by day
• Archive and restore flows for completed or cancelled work

Planning

• Initiatives, workstreams, tasks, and checklists
• Workstream and initiative assignment for tasks
• Initiative templates for reusable planning structures such as launches, migrations, and incident response

AI Collaboration

• Built-in MCP access for AI clients
• AI profiles and task ownership for agent collaborators
• Tools for agents to read and update tasks, planning entities, documents, image reviews, schedules, and attachments
• Local MCP support for clients such as Codex, Claude Code CLI, and Gemini CLI
• Cloud MCP access for hosted remote clients

Document And Image Review

• Document review sessions with threaded comments
• Image Notes for visual review with saved annotation sessions and markers
• AI-assisted document and image review workflows

Sync And Hosted Workspaces

• Local workspace data for private, machine-local use
• Hosted workspaces for cloud-backed collaboration
• Workspace sync between local and cloud environments
• Account, auth, and billing flows for hosted usage

MCP

Taskforce includes built-in MCP support so AI clients can work directly with your workspace.

Local MCP is for AI clients running on the same machine as your workspace. It does not require a cloud token.

Cloud MCP is for hosted remote clients and uses token-based access.

Uninstall Taskforce

If you installed with npm:

npm uninstall --global @taskforcehq/taskforce

If you installed with Homebrew:

brew uninstall taskforce

Your workspace data remains in each workspace's .taskforce/ directory.

Requirements

• Node.js 20+
• npm, or Homebrew on macOS

Support

Taskforce is in beta. For issues and feedback, use GitHub Issues:

https://github.com/taskforcehq/taskforce/issues

Status

Taskforce is in active beta development. This README describes the user-facing capabilities that are ready to try today.