@tomkapa/tayto 0.5.0 → 0.5.1

package/README.md

@@ -8,235 +8,121 @@
 
 **Stop losing tasks between AI sessions. Stop drowning in Jira fields you don't need.**
 
-Tayto is a local-first task manager built for solo developers who work with AI coding agents. Two interfaces, one SQLite database, zero configuration.
+A local-first task manager built for solo developers who work with AI coding agents.
+CLI for agents. TUI for humans. One SQLite database. Zero configuration.
 
-[Quick Start](#quick-start) • [Why Tayto](#why-tayto) • [Workflow](#workflow) • [CLI Reference](#cli-reference) • [TUI Reference](#tui-reference)
+[Install](#install) • [Workflow](#workflow) • [Agent Integration](#works-with-every-coding-agent) • [Claude Code Skills](#claude-code-skills)
 
 </div>
 
 ---
 
-## Why Tayto
+## Install
 
-Every project management tool out there assumes you're on a team. They want you to configure sprints, assign story points, set due dates, and fill out fifteen fields before you can track a single task.
+```bash
+npm install -g @tomkapa/tayto
+```
 
-If you're a solo dev shipping with AI agents like Claude Code, you need something different:
+**Requires:** Node.js >= 25
 
-- **You forget things.** A quick idea during a coding session, a tech debt note from an AI-generated feature, a bug you noticed but can't fix right now. Without a fast capture tool, these vanish.
-- **AI generates work faster than you can track it.** Your agent builds five features in an afternoon. Each one leaves behind edge cases, missing tests, and shortcuts. That debt is invisible until it bites you.
-- **Priority fields are a lie.** When you're the only one executing, all that matters is order: what's first, what's next. Row 1 in the task list is what you do now. That's it.
-- **Your AI agent can't use Jira.** It needs a CLI that speaks JSON. Your existing tools weren't built for this.
+---
 
-Tayto solves exactly this: a **CLI for agents** and a **TUI for humans**, sharing the same local SQLite database. No server. No login. No internet required.
+## Demo
+
+<video src="https://github.com/user-attachments/assets/bfd9e515-4ca6-4bd8-9bc3-d1b94eebf869" controls width="100%"></video>
 
 ---
 
 ## Workflow
 
-Tayto follows a lean, agile-inspired loop designed for how solo devs actually work:
-
 ![Workflow](workflow.png)
 
-**1. Capture** &mdash; Use AI to generate tasks from feature plans, record tech debt, or break down epics. Never lose an idea again.
+**1. Capture** &mdash; AI generates tasks from feature plans, records tech debt, logs bugs.
 
-**2. Prioritize** &mdash; You review the backlog and drag tasks into execution order. No story points. No priority matrices. Just: what's first?
+**2. Prioritize** &mdash; You drag tasks into execution order. No story points. Just: what's first?
 
-**3. Enrich** &mdash; AI analyzes the codebase and writes implementation-ready technical notes for the top backlog items.
+**3. Enrich** &mdash; AI researches the codebase and writes implementation-ready technical notes.
 
-**4. Review** &mdash; You read the plan. Approve it, adjust it, or send it back.
+**4. Review** &mdash; You read the plan. Approve, adjust, or send it back.
 
-**5. Execute** &mdash; AI implements the first `todo` task. You review the code. Cycle repeats.
-
-> Don't plan too far ahead. Keep tasks in the backlog. If something becomes urgent, re-rank it. Enrich only what's next. Ship what's ready. Simple.
+**5. Execute** &mdash; AI implements the top `todo` task. You review the code. Cycle repeats.
 
 ---
 
-## Quick Start
-
-```bash
-# Install globally from npm
-npm install -g @tomkapa/tayto
-
-# Create a project (auto-links to current git repo)
-tayto project create -n "my-app" --default
-
-# Capture some tasks
-tayto task create -n "Fix auth token refresh" -t bug
-tayto task create -n "Add user dashboard" -t story
-tayto task create -n "Refactor DB connection pooling" -t tech-debt
-
-# Re-rank: put the bug at the top
-tayto task rank <bug-id> --top
-
-# Launch the TUI to review your backlog
-tayto
-```
-
----
+## Works With Every Coding Agent
 
-## Installation
+Tayto's CLI outputs structured JSON to stdout &mdash; any agent with shell access can manage your tasks.
 
-```bash
-npm install -g @tomkapa/tayto
-```
-
-Or build from source:
-
-```bash
-git clone https://github.com/tomkapa/tayto && cd tayto
-npm install && npm run build
-npm link
+```jsonc
+// Every command returns a consistent envelope
+{ "ok": true, "data": { ... } }
 ```
 
-**Requires:** Node.js >= 25
+<table>
+<tr>
+<td align="center" width="150">
+<img src="https://cdn.simpleicons.org/anthropic/D97757" width="40" height="40" alt="Claude Code"><br>
+<b>Claude Code</b><br>
+<sub>First-class skills</sub>
+</td>
+<td align="center" width="150">
+<img src="https://cdn.simpleicons.org/cursor/000000" width="40" height="40" alt="Cursor"><br>
+<b>Cursor</b><br>
+<sub>Agent mode / terminal</sub>
+</td>
+<td align="center" width="150">
+<img src="https://cdn.simpleicons.org/windsurf/0066FF" width="40" height="40" alt="Windsurf"><br>
+<b>Windsurf</b><br>
+<sub>Cascade / terminal</sub>
+</td>
+<td align="center" width="150">
+<img src="https://cdn.simpleicons.org/github/181717" width="40" height="40" alt="GitHub Copilot"><br>
+<b>GitHub Copilot</b><br>
+<sub>Agent mode / terminal</sub>
+</td>
+<td align="center" width="150">
+<img src="https://cdn.simpleicons.org/cline/5A9" width="40" height="40" alt="Cline"><br>
+<b>Cline</b><br>
+<sub>VS Code agent</sub>
+</td>
+</tr>
+</table>
+
+No plugins. No API keys. Just install Tayto and your agent can `tayto task list`, `tayto task create`, and `tayto task update` out of the box.
 
 ---
 
-## Two Interfaces, One Database
+## Claude Code Skills
 
-### CLI &mdash; Built for AI Agents and Scripts
+Tayto ships with [Claude Code skills](https://docs.anthropic.com/en/docs/claude-code/skills) for the full AI-assisted workflow &mdash; no prompt engineering required.
 
-Every command returns structured JSON to stdout. Errors go to stderr with exit code 1.
+### `/tayto`
 
-```jsonc
-// Success
-{ "ok": true, "data": { ... } }
-
-// Error
-{ "ok": false, "error": { "code": "NOT_FOUND", "message": "..." } }
-```
+Manage projects and tasks directly from conversation. Create tasks, search the backlog, re-rank priorities, manage dependencies &mdash; all without leaving Claude Code.
 
-This makes Tayto a natural fit for AI coding agents. Claude Code can create tasks, search the backlog, read technical notes, and update status &mdash; all through simple CLI calls.
+### `/enrich-task`
 
-### TUI &mdash; Built for Humans
+Picks the next backlog task, researches the codebase for relevant patterns and architecture, then writes self-contained technical notes with implementation steps, acceptance criteria, and package recommendations. Splits out future enhancements as tech-debt tasks automatically.
 
-Run `tayto` with no arguments to launch an interactive terminal UI with:
+### `/implement-task`
 
-- Rich markdown rendering for task descriptions and technical notes
-- Vim-style navigation (`j`/`k`)
-- Inline filtering by status, type, and priority
-- Full-text search across all task fields
-- Task creation, editing, and status management without leaving the terminal
+Picks the highest-priority `todo` task, reads its technical notes, checks dependencies, then implements the feature step by step. Verifies the implementation against acceptance criteria before marking done.
 
----
-
-## CLI Reference
+### Adding skills to your project
 
-### Project Management
+Install from the community registry:
 
 ```bash
-tayto project create -n "my-app" -d "Description" --default
-tayto project list
-tayto project update <id> -n "new-name" --default
-tayto project delete <id>
-tayto project link <id> --remote <git-remote-url>
-tayto project unlink <id>
+npx skills add tomkapa/tayto
 ```
 
-Projects auto-detect the current git remote, so `tayto` in a repo directory uses the right project automatically.
-
-### Task Management
+Or from the Claude Code marketplace:
 
 ```bash
-# Create
-tayto task create \
-  -n "Fix login bug" \
-  -t bug \
-  -s todo \
-  -p "my-app" \
-  -d "Login fails on mobile" \
-  --technical-notes "Check JWT expiry logic" \
-  --additional-requirements "Must work on iOS Safari"
-
-# List and search
-tayto task list
-tayto task list --status in-progress --type bug
-tayto task search "login"
-
-# Update
-tayto task update <id> -s in-progress
-tayto task update <id> --append-notes "Root cause: token not refreshed"
-tayto task update <id> --append-requirements "Also fix on Android"
-
-# Re-rank (execution order)
-tayto task rank <id> --top
-tayto task rank <id> --bottom
-tayto task rank <id> --before <other-id>
-tayto task rank <id> --after <other-id>
-tayto task rank <id> --position 3
-
-# Break down into subtasks
-tayto task breakdown <parent-id> -f subtasks.json
-
-# Delete
-tayto task delete <id>
-
-# Export / Import
-tayto task export -o backup.json
-tayto task import -f backup.json
+/plugin marketplace add tomkapa/tayto
+/plugin install tayto
 ```
 
-### Dependency Management
-
-```bash
-tayto dep add <task-id> <depends-on-id>
-tayto dep add <task-id> <depends-on-id> -t blocked-by
-tayto dep remove <task-id> <depends-on-id>
-tayto dep list <task-id>
-tayto dep graph <task-id>
-```
-
-Dependency types: `blocks`, `blocked-by`, `relates-to`, `duplicates`
-
----
-
-## TUI Reference
-
-Launch with `tayto` or `tayto tui`.
-
-| Key | Action |
-|---|---|
-| `j` / `k` / arrows | Navigate |
-| `Enter` | Open task detail |
-| `c` | Create task |
-| `e` | Edit task |
-| `d` | Delete task |
-| `s` | Cycle status |
-| `/` | Search |
-| `f` | Filter by status |
-| `t` | Filter by type |
-| `0` | Clear filters |
-| `p` | Switch project |
-| `?` | Help |
-| `q` | Quit |
-
----
-
-## Data Model
-
-### Task Types
-
-| Type | Use for |
-|---|---|
-| `story` | Features and user stories |
-| `tech-debt` | Refactoring, cleanup, missing tests |
-| `bug` | Defects and issues |
-
-### Statuses
-
-`backlog` &rarr; `todo` &rarr; `in-progress` &rarr; `review` &rarr; `done` (or `cancelled`)
-
-### Task Fields
-
-Each task carries rich context for AI consumption:
-
-- **name** &mdash; short summary
-- **description** &mdash; user-facing details
-- **technical_notes** &mdash; implementation guidance (appendable)
-- **additional_requirements** &mdash; constraints and edge cases (appendable)
-- **rank** &mdash; execution order within the project
-- **parent_id** &mdash; hierarchical breakdown support
-
 ---
 
 ## Configuration
@@ -252,45 +138,6 @@ Database is created automatically on first run. All data stays on your machine.
 
 ---
 
-## Claude Code Integration
-
-Tayto ships with Claude Code skills for the full AI-assisted workflow:
-
-| Skill | What it does |
-|---|---|
-| `/tayto` | Manage projects and tasks from conversation |
-| `/implement-task` | Pick the top todo and implement it |
-| `/enrich-task` | Research the codebase and write technical notes for the next backlog item |
-
-The CLI's JSON output format means any AI agent with shell access can interact with Tayto &mdash; no special integration needed.
-
----
-
-## Architecture
-
-```
-CLI (Commander.js) ──┐
-                     ├──> Service Layer (Zod validation) ──> Repository ──> SQLite
-TUI (Ink/React) ─────┘
-```
-
-- **Result\<T\>** return type across all layers &mdash; no thrown exceptions
-- **OpenTelemetry** tracing on every operation
-- **FTS5** full-text search across task fields
-- **ULID** identifiers &mdash; sortable, collision-free
-- **Fractional ranking** &mdash; O(1) reorder without renumbering
-
----
-
-## Development
-
-```bash
-npm run dev          # watch mode
-npm run test         # run tests
-npm run check        # prettier + eslint
-npm run build        # production build
-```
-
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomkapa/tayto",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "CLI tool for task management - for solo devs and AI agents",
   "type": "module",
   "bin": {