{
  "markdown": "# Task CLI 🚀\n\nA premium, high-performance CLI Task Manager built with **React**, **Ink**, and **TypeScript**. Features a snappy terminal interface and a beautiful, interactive GUI mode.\n\n## ✨ Features\n\n- **Blazing Fast CLI**: Optimized startup using dynamic imports. CLI commands run in <100ms.\n- **Interactive GUI**: A stunning React-based terminal UI with real-time updates.\n- **Status Tracking**: Track tasks through `pending`, `in_progress`, and `completed` states.\n- **Due Dates**: Set and track deadlines with natural language parsing (e.g., \"tomorrow\", \"next friday\").\n- **Priority System**: Organize tasks by `high`, `medium`, or `low` priority.\n- **Search & Filter**: Find tasks instantly with text or `@tag` search.\n- **Intelligent Sorting**: Smart prioritization by status, due date, priority, and completion status.\n- **Codebase Scanner**: Automatically discover `TODO`, `FIXME`, and `BUG` comments in your code.\n- **Visual Progress**: Real-time progress bar tracking your daily productivity.\n- **Custom Theme**: Beautiful Pink aesthetics.\n\n## 🛠️ Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/chrisburlacu1/task-cli.git\ncd task-cli\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Link globally (optional)\nnpm link\n```\n\n## 📖 Usage\n\n### Interactive GUI Mode\n\nSimply run the command with no arguments:\n\n```bash\ntasks\n```\n\n**Controls:**\n\n- `a`: Add a new task\n- `f`: Search tasks (text or `@tag`)\n- `s`: Start task (set status to `in_progress`)\n- `x`: Stop task (set status to `pending`)\n- `space` / `enter`: Toggle completion\n- `d`: Delete selected task\n- `c`: Clear all completed tasks\n- `q`: Quit\n\n### Command Line Mode (Fast Path)\n\nManage your tasks directly from the terminal with subcommands:\n\n```bash\ntasks add \"Water the plants\" --high --due tomorrow   # Add with priority & date\ntasks start 1                                        # Mark task #1 as in-progress\ntasks stop 1                                         # Mark task #1 as pending\ntasks list --sort due                                # List sorted by deadline\ntasks done 1                                         # Toggle task #1\ntasks rm 2                                           # Delete task #2\ntasks clear                                          # Clear all completed tasks\ntasks archive                                        # Archive all completed tasks\ntasks history                                        # View archived tasks\n```\n\n## 🎨 Configuration\n\nThe theme can be customized in `src/theme.ts`. Change colors, text styles, and more to match your setup.\n\n## 💻 Development\n\n### Scripts\n\n- `npm start`: Run the CLI (use `-- <args>` to pass arguments).\n- `npm run build`: Compile TypeScript to `dist/`.\n- `npm test`: Run tests with Vitest.\n- `npm run lint`: Run ESLint.\n- `npm run format`: Format code with Prettier.\n\n## 🗄️ Tech Stack\n\n- **Framework**: [Ink](https://github.com/vadimdemedes/ink) (React for CLI)\n- **Storage**: `conf` (Local persistence)\n- **Validation**: `zod`\n- **Utilities**: `date-fns`, `nanoid`\n\n---\n\nBuilt with ❤️ for rapid productivity using **Gemini 3 Flash**.\n_(This project was entirely AI-generated)_\n\n## 🤖 Gemini CLI Extension\n\nYou can also manage your tasks directly through the Gemini CLI!\n\n### 1. Link the extension\n\nIn this directory, run:\n\n```bash\ngemini extensions link .\n```\n\n### 2. Available Tools\n\nThe Gemini agent will have access to:\n\n- `add_task`: Add tasks with priorities, `@tags`, and **due dates**.\n- `list_tasks`: See everything on your plate, with optional date filtering.\n- `update_task`: Modify existing tasks (text, priority, due date).\n- `set_task_status`: Explicitly set status (`pending`, `in_progress`, `completed`).\n- `get_all_tags`: See all tags currently in use.\n- `search_tasks`: Smart fuzzy search to find tasks without listing everything.\n- `git_branch_from_task`: Create a git branch directly from a task ID.\n- `scan_todos`: Scan your codebase for `TODO`/`FIXME` comments.\n- `read_meeting_actions`: Extract tasks from a meeting notes file intelligently.\n- `bulk_add_tasks`: Convert multiple scanned items into tasks in one turn.\n- `toggle_task`: Mark tasks as done/pending.\n- `delete_task`: Remove tasks.\n- `clear_completed`: Bulk clean-up.\n\nAsk Gemini: _\"Find the login task and create a branch for it.\"_\n",
  "bytes": 4316,
  "sha": "683ed1a705ee2e2027df22b0dd57afaecfb70ac2d8f46ad63caa0dda21b65406",
  "repo_slug": "chrisburlacu1/task-cli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_chrisburlacu1_task_cli_6d5da6bd/readme"
}