aitasks 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aitasks contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# aitasks
+
+> CLI task management built for AI agents.
+
+`aitasks` gives AI agents (Claude, Gemini, GPT, etc.) a structured task queue to work from. Agents can claim tasks, log progress notes, verify acceptance criteria with evidence, and hand off work — all via simple shell commands.
+
+**Requires [Bun](https://bun.sh) ≥ 1.0.0.**
+
+---
+
+## Install
+
+```sh
+bun install -g aitasks
+```
+
+## Quick Start
+
+```sh
+# 1. Initialize in your project
+aitasks init
+
+# 2. Create a task
+aitasks create --title "Add JWT auth" --priority high --ac "POST /login returns token" --ac "Token expires in 1h"
+
+# 3. Agent picks up work
+aitasks next --agent claude-sonnet
+
+# 4. Claim and start
+aitasks claim TASK-001 --agent claude-sonnet
+aitasks start TASK-001 --agent claude-sonnet
+
+# 5. Log notes along the way
+aitasks note TASK-001 "Using bcrypt for hashing — src/auth.ts:L22" --agent claude-sonnet
+
+# 6. Verify acceptance criteria
+aitasks check TASK-001 0 --evidence "POST /login returns 200 with token field" --agent claude-sonnet
+aitasks check TASK-001 1 --evidence "token exp claim set to now+3600, confirmed in jwt.test.ts:L14"
+
+# 7. Mark done
+aitasks done TASK-001 --agent claude-sonnet
+```
+
+---
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `AITASKS_AGENT_ID` | Default agent ID — avoids passing `--agent` on every command |
+| `AITASKS_JSON` | Set to `true` to force JSON output globally (useful for scripting) |
+
+```sh
+export AITASKS_AGENT_ID=claude-sonnet
+export AITASKS_JSON=true
+```
+
+---
+
+## Commands
+
+### Setup
+
+| Command | Description |
+|---|---|
+| `aitasks init` | Initialize a task database in the current project |
+| `aitasks onboard` | Print or inject agent protocol instructions into CLAUDE.md / AGENTS.md |
+
+### Task Discovery
+
+| Command | Description |
+|---|---|
+| `aitasks list` | List all tasks, sorted by priority |
+| `aitasks list --status ready` | Filter by status (`ready`, `in_progress`, `done`, `blocked`, `needs_review`) |
+| `aitasks next` | Show the highest-priority unblocked ready task |
+| `aitasks show <id>` | Full detail on a specific task |
+| `aitasks board` | Kanban-style board view |
+
+### Task Lifecycle
+
+| Command | Description |
+|---|---|
+| `aitasks create` | Create a task (interactive if no flags given) |
+| `aitasks claim <id> --agent <id>` | Claim a task |
+| `aitasks start <id> --agent <id>` | Begin active work |
+| `aitasks note <id> <text>` | Add an implementation note |
+| `aitasks check <id> <n> --evidence <text>` | Verify acceptance criterion n |
+| `aitasks done <id> --agent <id>` | Mark complete (all criteria must be verified) |
+| `aitasks review <id> --agent <id>` | Submit for human review |
+| `aitasks reject <id> --reason <text>` | Reject and send back to in_progress |
+| `aitasks unclaim <id> --agent <id>` | Release a task back to the pool |
+
+### Blocking
+
+| Command | Description |
+|---|---|
+| `aitasks block <id> --on <id,...>` | Mark a task as blocked by others |
+| `aitasks unblock <id> --from <id>` | Manually remove a blocker |
+
+### Agents & History
+
+| Command | Description |
+|---|---|
+| `aitasks agents` | List active agents and their current tasks |
+| `aitasks heartbeat [taskId]` | Update agent last-seen timestamp |
+| `aitasks log <id>` | Full event history for a task |
+| `aitasks export --format json` | Export all tasks as JSON |
+| `aitasks export --format csv` | Export all tasks as CSV |
+
+### Database
+
+| Command | Description |
+|---|---|
+| `aitasks db status` | Show database health and stats |
+
+---
+
+## `create` Flags
+
+```sh
+aitasks create \
+  --title "My task" \
+  --desc "Longer description" \
+  --priority high \        # critical | high | medium | low (default: medium)
+  --type feature \         # feature | bug | chore | docs
+  --ac "Returns 200" \     # Acceptance criterion (repeatable)
+  --parent TASK-001        # Parent task ID
+```
+
+---
+
+## Agent Protocol
+
+When you run `aitasks init`, it automatically injects a full agent protocol into `CLAUDE.md`, `AGENTS.md`, or `GEMINI.md` (whichever exists, or creates `AGENTS.md`). This tells the AI agent exactly how to use `aitasks`.
+
+You can also inject/view it manually:
+
+```sh
+aitasks onboard               # print to stdout
+aitasks onboard --append      # append to detected agent file
+aitasks onboard --file MY.md  # append to a specific file
+aitasks onboard --json        # output as JSON string
+```
+
+---
+
+## Data Storage
+
+`aitasks init` creates a `.aitasks/` directory in your project root containing a SQLite database. Add `.aitasks/` to your `.gitignore` if you don't want to commit task data, or commit it to share tasks across your team.
+
+---
+
+## License
+
+MIT