{"id":44871676,"url":"https://github.com/beyondeye/aitasks","last_synced_at":"2026-04-26T18:00:27.721Z","repository":{"id":338030991,"uuid":"1155243443","full_name":"beyondeye/aitasks","owner":"beyondeye","description":"an agentic IDE in your terminal, markdown tasks with YAML frontmatter, git-native, zero infrastructure. Works with Claude Code, Gemini CLI, OpenCode, and Codex CLI.","archived":false,"fork":false,"pushed_at":"2026-04-23T10:02:29.000Z","size":20807,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T10:06:51.297Z","etag":null,"topics":["ai-agents","automation","bash","claude-code","cli","code-quality","code-review","codex-cli","coding-agents","developer-tools","gemini-cli","git","kanban","opencode","orchestration","skills","task-management","tui"],"latest_commit_sha":null,"homepage":"https://aitasks.io","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beyondeye.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-11T09:40:04.000Z","updated_at":"2026-04-23T10:02:33.000Z","dependencies_parsed_at":"2026-04-23T10:02:59.338Z","dependency_job_id":null,"html_url":"https://github.com/beyondeye/aitasks","commit_stats":null,"previous_names":["beyondeye/aitasks"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/beyondeye/aitasks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondeye%2Faitasks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondeye%2Faitasks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondeye%2Faitasks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondeye%2Faitasks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beyondeye","download_url":"https://codeload.github.com/beyondeye/aitasks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondeye%2Faitasks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32307015,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T17:23:19.671Z","status":"ssl_error","status_checked_at":"2026-04-26T17:23:19.195Z","response_time":129,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","automation","bash","claude-code","cli","code-quality","code-review","codex-cli","coding-agents","developer-tools","gemini-cli","git","kanban","opencode","orchestration","skills","task-management","tui"],"created_at":"2026-02-17T13:11:57.517Z","updated_at":"2026-04-26T18:00:27.713Z","avatar_url":"https://github.com/beyondeye.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"imgs/aitasks_logo_dark_theme_im.png\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"imgs/aitasks_logo_light_theme_pil.png\"\u003e\n    \u003cimg alt=\"aitasks logo\" src=\"imgs/aitasks_logo_light_theme_pil.png\" width=\"400\"\u003e\n  \u003c/picture\u003e\n\n  \u003ch3\u003e\u003cem\u003eA full agentic IDE in your terminal. File-based, git-native, multi-agent.\u003c/em\u003e\u003c/h3\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://aitasks.io/\"\u003e\u003cimg src=\"https://img.shields.io/badge/docs-website-blue\" alt=\"Documentation\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/beyondeye/aitasks/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/beyondeye/aitasks?style=social\" alt=\"GitHub stars\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/beyondeye/aitasks/commits/main\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/beyondeye/aitasks\" alt=\"Last commit\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/beyondeye/aitasks/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/beyondeye/aitasks\" alt=\"GitHub issues\"/\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\nA full agentic IDE in your terminal — kanban board, code browser, agent monitoring, and AI-enhanced git workflows — integrated with AI code agents ([Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Codex CLI](https://github.com/openai/codex), [OpenCode](https://github.com/opencode-ai/opencode)) via skills. Tasks are markdown files with YAML frontmatter stored in your repo alongside your code. No backend. No database. Just git.\n\nBuilt for maximizing development speed 🚀 AND human-to-agent intent transfer efficiency 💬.\n\n## 🎯 The Challenge\nAI coding agents are proficient enough to handle real development tasks. The bottleneck is **intent transfer** — getting structured, contextual instructions to the agent without the human becoming the slowdown. **aitasks** optimizes both the context the agent sees and the speed at which a human can steer it.\n\n## 💡 Core Philosophy\n\"Light Spec\" engine: unlike rigid Spec-Driven Development, tasks here are **living documents**.\n  - **Raw Intent:** a task starts as a simple Markdown file capturing the goal.\n  - **Iterative Refinement:** an AI workflow refines task files in stages — expanding context, adding technical details, and verifying requirements — before code is written.\n\n## 🏗️ Key Features \u0026 Architecture\n\n- **🖥️ Agentic IDE in your terminal** — Board, Code Browser, Monitor, Brainstorm, and Settings TUIs in one tmux session via `ait ide`. Press `j` to hop between them.\n- **🧠 Long-term memory for agents** — archived tasks and plans become queryable context; the Code Browser annotates each line back to the task/plan that introduced it.\n- **🔀 Tight git coupling, AI-enhanced** — PR import/close, issue tracker integration, contribution flow, changelog generation, and AI-assisted reverts — all rooted in git commits and task metadata.\n- **🧩 Task decomposition \u0026 parallelism** — auto-explode complex tasks into child tasks; sibling context propagates via archived plans; git worktrees + atomic locks for parallel agent work.\n- **🔍 AI-enhanced code review** — per-language review guides, batched multi-file reviews producing follow-up tasks, QA workflow with test-coverage analysis.\n- **🤖 Multi-agent support with verified scores** — unified `codeagent` wrapper over Claude Code / Gemini CLI / Codex CLI / OpenCode; per-model/per-operation scores accumulated from user feedback.\n\n- **Dual-Mode CLI** — interactive mode for humans (optimized for flow, no context switching) and batch mode for agents (programmatic task/status updates).\n\n- **Battle tested** — actively developed and used in real projects.\n\n- **Fully customizable workflow** — scripts and skills live in your project repo; modify them for your needs and contribute back via `/aitask-contribute`. See the [Contribute and Manage Contributions workflow](https://aitasks.io/docs/workflows/contribute-and-manage/).\n\n## 🖥️ Platform Support\n\n| Platform | Status | Notes |\n|----------|--------|-------|\n| Arch Linux | Fully supported | Primary development platform |\n| Ubuntu/Debian | Fully supported | Includes Pop!_OS, Linux Mint, Elementary |\n| Fedora/RHEL | Fully supported | Includes CentOS, Rocky, Alma |\n| macOS | Fully supported | Requires Homebrew for bash 5 and coreutils (auto-installed by `ait setup`) |\n| Windows (WSL) | Fully supported | Via WSL with Ubuntu/Debian (see [Windows guide](https://aitasks.io/docs/installation/windows-wsl/)) |\n\n## ⚡ Quick Install\n\nInstall into your project directory:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/beyondeye/aitasks/main/install.sh | bash\nait setup\n```\n\n\u003e **Windows users:** Run this inside a WSL shell, not PowerShell. See the [Windows/WSL guide](https://aitasks.io/docs/installation/windows-wsl/).\n\n`ait setup` installs dependencies and configures Claude Code permissions. See [`ait setup`](https://aitasks.io/docs/commands/setup-install/) for details.\n\nUpgrade an existing installation:\n\n```bash\nait upgrade latest\nait setup\n```\n\nOr for fresh installs without an existing `ait` dispatcher:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/beyondeye/aitasks/main/install.sh | bash -s -- --force\nait setup\n```\n\n**Already have the global `ait` shim?** If you've previously run `install.sh` on another project, the global shim at `~/.local/bin/ait` is already installed. You can bootstrap aitasks in any new project directory by simply running:\n\n```bash\ncd /path/to/new-project\nait setup\n```\n\nThe shim detects that no aitasks project exists, downloads the latest release, installs it, and then runs the full setup — all in one command.\n\n**Windows/WSL users:** See the [Windows/WSL Installation Guide](https://aitasks.io/docs/installation/windows-wsl/) for step-by-step instructions including WSL setup, Claude Code installation, and terminal configuration.\n\n## 📦 What Gets Installed\n\n**Per-project files** (committed to your repo):\n\n- `ait` — CLI dispatcher script\n- `.aitask-scripts/` — Framework scripts (task management, board, stats, etc.)\n- `.claude/skills/aitask-*` — Claude Code skill definitions\n- `aitasks/` — Task data directory (auto-created)\n- `aiplans/` — Implementation plans directory (auto-created)\n\n**Global dependencies** (installed once per machine via `install.sh` and `ait setup`):\n\n- CLI tools: `fzf`, `gh` (for GitHub), `glab` (for GitLab), or `bkt` (for Bitbucket), `jq`, `git`\n- Python venv at `~/.aitask/venv/` with `textual`, `pyyaml`, `linkify-it-py`\n- Global `ait` shim at `~/.local/bin/ait`\n- Claude Code permissions in `.claude/settings.local.json` (see [Claude Code Permissions](https://aitasks.io/docs/commands/setup-install/#claude-code-permissions))\n\n## 📖 Documentation\n\n**[Documentation Website](https://aitasks.io/)** — Browse the full documentation online.\n\n- **[Overview](https://aitasks.io/docs/overview/)** — The challenge aitasks addresses, its core philosophy, and key features of the agentic IDE.\n\n- **[Installation](https://aitasks.io/docs/installation/)** — Quick install, platform support, setup, and git remote authentication.\n\n- **[Getting Started](https://aitasks.io/docs/getting-started/)** — First-time walkthrough from install to completing your first task.\n\n- **[Concepts](https://aitasks.io/docs/concepts/)** — What each building block is and why it exists: tasks, plans, parent/child, folded tasks, review guides, execution profiles, verified scores, agent attribution, locks, and the IDE model.\n\n- **[TUI Applications](https://aitasks.io/docs/tuis/)** — The terminal IDE: Monitor, Minimonitor, Board, Code Browser, Settings, and Brainstorm — hop between them with a single keystroke via `ait ide`.\n\n- **[Workflow Guides](https://aitasks.io/docs/workflows/)** — End-to-end guides for common usage patterns: capturing ideas fast, tmux IDE, complex task decomposition, parallel development, code review, QA, PR workflow, and more.\n\n- **[Code Agent Skills](https://aitasks.io/docs/skills/)** — Reference for `/aitask-pick`, `/aitask-explore`, `/aitask-create`, and other skill integrations across Claude Code, Gemini CLI, Codex CLI, and OpenCode.\n\n- **[Command Reference](https://aitasks.io/docs/commands/)** — Complete CLI reference for all `ait` subcommands.\n\n- **[Development Guide](https://aitasks.io/docs/development/)** — Architecture overview, directory layout, library scripts, and release process.\n\n## 📄 License\nThis project is licensed under the Apache License 2.0 with the Commons Clause condition.\n\nWhat this means:\n✅ You can: Use, copy, and modify the code for free, with an explicit patent grant from contributors.\n\n✅ You can: Use aitasks as a library to power your own commercial products or SaaS applications.\n\n❌ You cannot: Sell aitasks itself, or a derivative version of it, as a standalone product or service (e.g., selling a \"Pro\" version of the library or a managed aitasks hosting service) without prior written consent.\n\nFor the full legal text, please see the [LICENSE](LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeyondeye%2Faitasks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeyondeye%2Faitasks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeyondeye%2Faitasks/lists"}