
outask
io.github.henryh/outask
Read and manage repository-local JSON tasks with Outask.
Documentation
Outask AI
Outask is a lightweight task tracker for personal projects and your AI harness. Keep active, completed and archived tasks alongside project code as readable JSON, so you and local coding agents share the same task history through CLI or MCP.
Use outask from your terminal. tasks is a permanent alias for the same installation.
Install the CLI
Run npm install -g outask with Node.js 22.23.3 or later. For platform archives, offline installation, and source checkouts, see Install Outask.
Basic use
Run in your project directory:
outask create --title "Write release notes"
outask list --format table
outask search "release notes"
outask transition 1 --status done
outask list --group Done
Use the ID returned by create in place of 1. The first write prepares task
storage; no setup command is needed. Discover commands with outask --help,
or use the operator cookbook.
Use with an agent
Connect the local Outask MCP adapter to your agent and start a new session. See MCP setup for client and platform instructions.
To use Plan to Tasks, copy its folder into your agent's skills directory and enable it.
Contributing
See contributor setup and delivery.
License
Copyright (c) 2026 Henry me@henrydev.me. Licensed under GNU AGPL version 3 only.
outasknpm install outask