# agencycli

> Lightweight CLI to build self-managing AI agent teams. Define roles, skills & projects in Markdown+YAML — agents run autonomously on a heartbeat schedule, talk to each other via inbox, and delegate ta

- **URL**: https://www.freshcrate.ai/projects/agencycli
- **Author**: chenhg5
- **Category**: AI Agents
- **Latest version**: `v0.6.0` (2026-05-09)
- **License**: Unknown
- **Source**: https://github.com/chenhg5/agencycli
- **Language**: Go
- **GitHub**: 71 stars, 2 forks
- **Registry**: github (`chenhg5/agencycli`)
- **Tags**: `go`

## Description

Lightweight CLI to build self-managing AI agent teams. Define roles, skills & projects in Markdown+YAML — agents run autonomously on a heartbeat schedule, talk to each other via inbox, and delegate tasks. Works with Claude Code, Codex, Gemini, Cursor & more.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.6.0` | 2026-05-09 | High | ## v0.6.0 — 2026-05-09  ### Features - Add project repo/desc editing and agent add_dirs config in web UI  ### Bug Fixes - Add dark mode hover styles for buttons across all web components - Handle codex resume errors and discard failed session IDs - Improve conversation diffs and codex sandbox tools in web UI - Compact agent chat diff rendering - Properly place --add-dir between exec and resume subcommand - Move --add-dir before resume subcommand - Render codex agent chat history in web UI - Impr |
| `v0.5.2` | 2026-05-02 | High | ## v0.5.2 — 2026-05-02  ### Features  - **Web UI**: Add agent avatars with customizable images - **Web UI**: Improve skill catalog display and chat state persistence - **Web UI**: Add quick links and agent navigation improvements - **Web UI**: Allow switching between agent chat sessions - **Web UI**: Add ability to hide/show AI assistant widget (right-click to hide) - **Cron**: Add jitter support for heartbeat scheduling - **Cron**: Support custom session ID and fix runCount/sessionId display - |
| `v0.5.1` | 2026-04-24 | High | File manager, docs TOC, cron session scope, competitive analysis docs |
| `v0.5.0` | 2026-04-19 | High | ## What's New in v0.5.0  ### Added - **Provider management CLI** — `agencycli provider` commands (add/list/remove/set-default) - **Setup guidance system** — interactive first-run wizard for new workspaces - **Cron editing UI** — inline expression/prompt/toggle editing in web console - **Fire crons during sleep** — pending crons execute immediately during heartbeat sleep phase - **Agent identity env vars** — `AGENCYCLI_AGENT`, `AGENCYCLI_PROJECT`, etc. injected into every process - **Abort runnin |
| `v0.4.1` | 2026-04-14 | Medium | AgencyCli v0.4.1 发布说明  主要更新:  🔐 环境变量管理 - 全新工作区环境变量（envvars）：支持全局或指定 Agent 作用域 - 运行时自动注入，优先级链：全局 → Agent 级 → Provider → 独立 Agent 环境变量 - CLI 命令：agencycli envvar add/list/remove + agent set-env/unset-env/list-env - Web 设置页：按项目分组的 Agent 多选器，环境变量增删改查 - Agent 详情页：环境变量面板，敏感值遮盖 + 👁 切换查看，内联编辑  ⚡ 事件触发调度 - 新增触发式调度：收到消息或分配任务时自动唤醒 Agent - CLI 和 Web 心跳编辑器均可配置触发器 - 去重执行 + 可配置冷却时间  📊 工作台增强 - 项目调度概览卡片：Agent 数、运行中数、调度状态、任务/消息数 - 支持单项目开关调度 + "全部启动"按钮 - 任务 Tab 显示待处理数量 - 项目卡片显示运行中 Agent 数  📚 知识库改进 - 文档全屏模式：隐藏导航居 |
| `v0.4.0` | 2026-04-11 | Medium | ## AgencyCli v0.4.0  ### Added  **Goal Management (OKR & Milestones)** - OKR system: Objectives with Key Results supporting number/percentage/boolean/currency metric types - Milestone management: project-level milestones with completion criteria, task labels, and due dates - OKR web dashboard with inline KR editing, create/edit/delete modals, and description fields - Milestone panel with create/edit modal, progress tracking, and i18n-aware date formatting - CLI commands: `agencycli okr` and `age |
| `v0.3.0` | 2026-04-03 | Medium | ## What's New  ### Knowledge Base (docs) - Full document indexing system with virtual directory trees - `agencycli docs add/list/tree/show/update/move/remove/search` CLI commands - Web viewer with Notion-style Markdown rendering, syntax highlighting, YAML frontmatter stripping - Collapsible sidebar navigation, document download, URL deep-linking (`/docs/<index>/<slug>`)  ### AI Assistant - Built-in floating AI assistant widget (draggable, resizable) powered by Claude CLI - Streaming chat with pr |
| `v0.2.2` | 2026-03-30 | Medium | ### Fixed - npm install: Gitee fallback download URL pointed to wrong repository name (`cg33/agencycli` → `cg33/agentorg`)  **Full Changelog**: https://github.com/chenhg5/agencycli/compare/v0.2.1...v0.2.2 |
| `v0.2.1` | 2026-03-30 | Medium | ## What's Changed  ### Added - Workbench: sent messages view with direction filter (inbox / sent / all) - Task completion summary field with notification to task creator - Agent model switching (including http-agent API provider) from the web UI - Copy-to-clipboard resume command in schedule runtime session column - Refresh buttons on all table/filter pages - Multi-page tab bar in header for quick page switching  ### Fixed - Unread message badge not updating after processing messages - Scheduler |
| `v0.2.0` | 2026-03-29 | Medium | ## v0.2.0 — Built-in Web Console  ### Added  **Web Console (single-binary)** - `agencycli start` serves both API and web console on a single port — no separate frontend deployment needed - Workbench page: unified operator hub for messages and tasks with batch operations - Full message management: send (multi-recipient), reply, filter, batch archive/delete - Full task management: create, edit, view detail with execution logs, batch operations - Schedule management: tabbed Heartbeat / Cron / Runti |

## Dependency audit

- **Score**: 68/100
- **Total deps**: 5
- **Resolved**: 0
- **Unresolved**: 5
- **License conflicts**: 0
- **Warnings**: 6
- **Scanned**: 2026-05-11

## Citation

- HTML: https://www.freshcrate.ai/projects/agencycli
- Markdown: https://www.freshcrate.ai/projects/agencycli.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/agencycli/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._