Task You
A personal task management system with a beautiful terminal UI, SQLite storage, and background task execution via pluggable AI agents (Claude Code, OpenAI Codex, Gemini, Pi, OpenClaw, or OpenCode).
Screenshots
Kanban Board
The main view showing tasks organized across Backlog, In Progress, Blocked, and Done columns
Task Detail View
Viewing a task with Claude's output and shell access in split panes
Execution Log
Live execution log showing task progress, worktree creation, and Claude's actions
New Task Form
Creating a new task with project selection, type, scheduling, and attachments
Features
- Kanban Board - Visual task management with 4 columns (Backlog, In Progress, Blocked, Done)
- Git Worktrees - Each task runs in an isolated worktree, no conflicts between parallel tasks
- Pluggable Executors - Choose between Claude Code, OpenAI Codex, Gemini, Pi, OpenClaw, or OpenCode per task
- Event Hooks - Run scripts when tasks change state (see Event Hooks)
- Ghost Text Autocomplete - LLM-powered suggestions for task titles and descriptions as you type
- VS Code-style Fuzzy Search - Quick task navigation with smart matching (e.g., "dsno" matches "diseno website")
- Markdown Rendering - Task descriptions render with proper formatting in the detail view
- Real-time Updates - Watch tasks execute live
- Running Process Indicator - Green dot (
●) shows which tasks have active shell processes (servers, watchers, etc.)
- Auto-cleanup - Automatic cleanup of Claude processes for completed tasks (see maintenance commands for config cleanup)
- Fully Scriptable CLI - 100% of Task You is controllable via CLI—agents can manage tasks, read executor output, and send input to running executors programmatically (see Full CLI Scriptability)
- SSH Access - Run as an SSH server to access your tasks from anywhere (see SSH Access & Deployment)
- Project Context Caching - AI agents automatically cache codebase exploration results and reuse them across tasks, eliminating redundant exploration (see Project Context)
- Shell Completion - Tab completion for commands, task IDs, projects, statuses, and flags in bash, zsh, fish, and PowerShell (see Shell Completion)
Project Context
TaskYou implements intelligent codebase caching to make AI agents dramatically more efficient across multiple tasks in the same project.
How It Works
When an AI agent starts a task, it can:
- Check for cached context via
taskyou_get_project_context MCP tool
- Use existing context if available, skipping redundant exploration
- Explore once and save via
taskyou_set_project_context for future tasks
This cached context is stored in the projects.context database column and persists across all tasks in that project.
Benefits
- Faster task startup - No need to re-explore the codebase on every task
- Consistent understanding - All tasks share the same baseline knowledge
- Token efficiency - Avoids burning tokens on repeated exploration
- Better continuity - Agents build on previous learnings
Example Usage
When an agent starts a task, it first checks for context:
Agent: taskyou_get_project_context()
TaskYou: "## Cached Project Context
This is a Go project using:
- Bubble Tea for TUI
- SQLite for storage
- Charm libraries for styling
Key directories:
- internal/db/ - Database layer
- internal/executor/ - Task execution
- internal/ui/ - UI components
..."
If no context exists, the agent explores once and saves it:
Agent: [explores codebase]
Agent: taskyou_set_project_context("...")
TaskYou: "Project context saved. Future tasks will use this."
Best Practices
What to include in context:
- Project structure and key directories
- Tech stack and frameworks used
- Coding conventions and patterns
- Important files and their purposes
- Common development workflows
When to update:
- After major refactorings
- When new patterns are introduced
- After significant file reorganization
- When the tech stack changes
Context is per-project - Each project maintains its own cached context, preventing cross-contamination.
Related Features