{"id":50750563,"url":"https://github.com/flesler/ai-projects","last_synced_at":"2026-06-11T01:01:58.922Z","repository":{"id":349392235,"uuid":"1186696788","full_name":"flesler/ai-projects","owner":"flesler","description":"Project management CLI made for and maintained by AI","archived":false,"fork":false,"pushed_at":"2026-05-14T23:19:21.000Z","size":319,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T01:28:30.239Z","etag":null,"topics":["ai","cli","project","task","task-management"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flesler.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-03-19T22:34:59.000Z","updated_at":"2026-05-14T23:19:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/flesler/ai-projects","commit_stats":null,"previous_names":["flesler/ai-projects"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/flesler/ai-projects","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flesler%2Fai-projects","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flesler%2Fai-projects/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flesler%2Fai-projects/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flesler%2Fai-projects/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flesler","download_url":"https://codeload.github.com/flesler/ai-projects/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flesler%2Fai-projects/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34177444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","cli","project","task","task-management"],"created_at":"2026-06-11T01:01:53.929Z","updated_at":"2026-06-11T01:01:58.895Z","avatar_url":"https://github.com/flesler.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AIP - AI Project Management CLI 🤖\n\n**Built for AI agents. Polished by AI agents.**\n\nA command-line tool for managing AI agent projects, tasks, and agents with structured workflows, activity logging, and automation hooks.\n\n## 📚 Help System\n\nAIP has a comprehensive built-in help system for every level:\n\n```bash\n# 🚀 New here? Start with the quick guide\naip help quickstart\n\n# 📋 Read list of verbs by all nouns\naip --help          # Same as `aip help usage`\n\n# 🎯 List of verbs by noun\naip task --help      # Same as `aip help usage task`\n\n# 📋 Get all parameters and --options for a command\naip task create --help\n\n# 📖 Complete API reference (comprehensive!)\naip help api\n\n# 🛠️ Project management skill documentation (can be piped to a SKILL.md)\naip help skill\n\n# 🔗 Hook system documentation\naip help hooks\n```\n\n## ✨ Features\n\n- **Structured Projects**: YAML frontmatter + markdown body\n- **Activity Logging**: TSV-based status tracking (date, time, type, action, text)\n- **Automation Hooks**: Pre/post hooks for create, start, update, complete\n- **Multi-line Support**: Heredoc syntax for complex content\n- **Agent-Ready**: Designed for autonomous AI workflows\n\n## 🚀 Quick Start\n\n```bash\n# Create project with body (inline - cleanest)\naip project create \"my-project\" --description \"...\" --body $'# Goals\\n- Build X\\n- Solve Y'\n\n# Create project with body (here-string for multi-line)\naip project create \"my-project\" --description \"...\" --body \"$(cat \u003c\u003c\u003c '# Goals\n- Build X\n- Solve Y')\"\n\n# Create a task in the project\naip task create my-project \"first-task\" --description \"Get started\"\n\n# Navigate and work\ncd $(aip task path first-task)\n\n# Start working (and read in all context to stdout)\naip task start\n\n# Log your progress\naip log append \"API integration complete\"\n\n# View activity history\naip log read\n```\n\n## 🏠 AIP_HOME - Project Root Directory\n\nAIP stores all projects, tasks, and agents under `$AIP_HOME`.\n\n**Set it in your `~/.bashrc` (or `~/.zshrc`):**\n```bash\nexport AIP_HOME=/path/to/your/aip-root\n```\n\n**Auto-detection (if `AIP_HOME` is not set):**\nAIP automatically detects the root by traversing up from your current directory looking for standard folders (`projects/`, `skills/`, `agents/`). This means you can `cd` anywhere in your project structure and AIP will find the root.\n\n```bash\n# No setup needed - just run from anywhere in your project\ncd /path/to/aip-root/projects/my-project/tasks/some-task\naip task list  # Works! AIP detected the root\n```\n\n## 📁 Project Structure\n\nOnce AIP_HOME is determined, the structure is:\n\n```\n$AIP_HOME/projects/{project}/\n├── main.md          # Goals + body (YAML frontmatter + markdown)\n├── log.tsv          # Activity log (tab-separated: date, time, type, slug, action, text)\n├── hooks/           # Automation: pre|post-{create,start,update,complete}\n├── inputs/          # Intermediate/raw data (e.g. API responses, downloads)\n├── outputs/         # Deliverables go here (e.g. reports, leads, etc.)\n├── scripts/         # Automation scripts\n└── tasks/{task}/\n    ├── main.md      # Task definition + body\n    ├── log.tsv      # Task activity log\n    └── ...          # Same substructure\n```\n\n## 🔧 Key Commands\n\n### Projects\n```bash\naip project create \"name\" --description \"...\" --body \"...\"\naip project update --status done --body \"$(cat final-report.md)\"\naip project list\naip project path my-project    # Get absolute path\n```\n\n### Tasks\n```bash\naip task create my-project \"task-name\" --description \"...\"\naip task update --status in-progress\naip task list --project my-project\naip task list --search \"-name\"\naip task path task-name        # Get absolute path\naip task start                 # Start working (and read in all context to stdout)\n```\n\n### Logging\n```bash\naip log append \"Completed the implementation\"\naip log append --task my-task \"Fixed the bug\"\naip log read                   # View status history\n```\n\n### Utilities\n```bash\naip help quickstart            # Get started guide\naip help skill --mode claude \u003e ~/.claude/skills/aip/SKILL.md\naip help skill --mode hermes \u003e ~/.hermes/skills/some_toolset/aip/SKILL.md\n```\n\n## 💡 Pro Tips\n\n```bash\n# Chain commands\ncd $(aip task path my-task) \u0026\u0026 aip task start\n\n# Use here-string for complex body content\naip project update --body \"$(cat \u003c\u003c\u003c '# Updated Goals\n- New goal 1\n- New goal 2')\"\n\n# Quick status check\naip log read | tail -5\n```\n\n## 🛠️ Development\n\nThis tool is **meant for AI agents** and will be **automatically polished by AI agents** based on their usage. \n\n**Suggestions and PRs welcome!** 🎉\n\n## 📄 License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflesler%2Fai-projects","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflesler%2Fai-projects","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflesler%2Fai-projects/lists"}