active-collab-cli
Unofficial ActiveCollab CLI, terminal UI (TUI) and MCP server: read tasks, log time and export hours from the terminal or from AI coding agents (Claude Code, Codex, OpenCode, Pi)
Install / Use
claude mcp add ejklock -- npx -y github:ejklock/active-collab-cliIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of active-collab-cli
active-collab-cli scores 74/100 on our quality scale, 3789th of 4,698 Development & Engineering skills we index.
Its MCP Server is 21 KB long, well organised into 50 sections with 25 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 2 days ago, so active-collab-cli is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
active-collab-cli compared with similar skills
All 4 of these similar skills score higher than active-collab-cli; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| active-collab-cli (this skill)by ejklock | 74 | 3 | 2d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install active-collab-cli?
- Run
claude mcp add ejklock -- npx -y github:ejklock/active-collab-cli. The install tabs above show the steps for each supported agent. - Which AI agents does active-collab-cli work with?
- It is written for Claude Code, Claude Desktop and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is active-collab-cli safe to use?
- It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is active-collab-cli still maintained?
- The repository was last updated 2 days ago, so active-collab-cli is actively maintained.
Skill content
View source on GitHubactive-collab-cli — ActiveCollab CLI, terminal UI and MCP server
Unofficial command-line client, interactive terminal UI (TUI) and
MCP server for self-hosted
ActiveCollab. Read your tasks, comments and
projects, log time, export hours reports and download attachments from the
terminal, or let an AI coding agent (Claude Code, Codex, OpenCode, Pi, Cursor,
GitHub Copilot) do it for you through the ac mcp server and the
active-collab skill.
One self-contained Rust binary (ac, built with ratatui, crossterm and tokio)
for Linux, macOS and Windows. No interpreter or runtime is required.
Features
ac mine: your open tasks grouped by due date, with estimate and the hours logged this week and in total.ac/ac get: the task for your current git branch, or any task by URL or short ref, with comments and attachments.ac browse: a keyboard-driven TUI over projects, task lists, tasks, comments and attachments; comment, log time, move a task to another task list, download attachments.ac time logandac time report: log hours, and export a period's hours as XLSX or CSV.--jsonon every read command, for scripts and agents.ac mcp: the same commands as MCP tools (ac_read,ac_write,ac_download_attachments), installed in one step by the Claude Code, Codex, OpenCode and Pi plugins.- Several ActiveCollab instances at once; API tokens stored locally in SQLite, passwords never stored.
- English and Brazilian Portuguese interface.
⚠️ Unofficial — not affiliated with ActiveCollab
This is an independent, community-built project. It is not an official ActiveCollab product and is not affiliated with, endorsed by, sponsored by, or supported by ActiveCollab or A51 d.o.o. "ActiveCollab" is a trademark of its respective owner and is used here only to describe compatibility with the ActiveCollab REST API of your own self-hosted instance. This tool stores no credentials beyond a local API token, sends that token only to your configured host, and is provided "as is", without warranty. Use at your own risk.
Screenshot
Interactive TUI — the task-detail view (project, status, description, assets). The data shown is fictional; no real instance or client data is depicted.
Quickstart
From zero to your first task in three steps:
# 1 · Install (macOS / Linux — Windows: see the PowerShell one-liner below)
curl -fsSL https://raw.githubusercontent.com/ejklock/active-collab-cli/main/install.sh | sh
# 2 · Register your self-hosted ActiveCollab instance.
# Prompts once for your password to exchange an API token — the password is never stored.
ac setup add --name collab --url https://collab.example.com --email you@example.com
# 3 · List the open tasks assigned to you
ac mine
To let an AI coding agent use it, add the plugin to your harness (see Plugins for Codex, OpenCode and Pi):
claude plugin marketplace add ejklock/active-collab-cli
claude plugin install active-collab@active-collab
Then, day to day:
ac # the task for your current git branch (e.g. feature/665-75159)
ac get 665/75159 # a specific task by short form or full URL
ac browse # full interactive TUI: projects → tasks → detail → assets
ac mine --json # machine-readable output for scripts and agents
New here? ac setup add walks you through it interactively if you omit the flags.
See Usage for every command and flag.
Install
macOS / Linux (curl one-liner)
curl -fsSL https://raw.githubusercontent.com/ejklock/active-collab-cli/main/install.sh | sh
The script downloads the pre-built active-collab binary for your platform from
the latest GitHub Release and places it on your PATH, next to an ac symlink —
the short command used throughout this README and by the agent skill. An ac
left by an older install is replaced; an ac belonging to another program is
kept, with a warning. macOS ships its own /usr/sbin/ac (login accounting), so
the installer also warns when that one still wins your PATH lookup.
Windows (PowerShell one-liner)
irm https://raw.githubusercontent.com/ejklock/active-collab-cli/main/install.ps1 | iex
Installs active-collab.exe plus an ac.cmd shim, so both active-collab and
ac work from cmd and PowerShell.
Manual download
Download the pre-built binary for your platform from the
Releases page, place it on your
PATH, and make it executable (chmod +x active-collab on Unix). Add the short
alias yourself: ln -s active-collab ac (Unix), or an ac.cmd forwarder on
Windows.
| Platform | Asset |
|---|---|
| Linux x86_64 | active-collab-linux-x86_64 |
| Linux arm64 | active-collab-linux-arm64 |
| macOS x86_64 (Intel) | active-collab-macos-x86_64 |
| macOS arm64 (Apple Silicon) | active-collab-macos-arm64 |
| Windows x86_64 | active-collab-windows-x86_64.exe |
Build from source (Docker required)
No local Rust toolchain needed. The crate is at the repo root; Docker provides the build environment.
# Development build
docker compose run --rm dev cargo build
# Release binary (placed in target/release/ac)
docker compose build
docker compose run --rm build
That binary is a Linux build. make install therefore only accepts a Linux host
and refuses elsewhere; on macOS use make install-native (needs a host Rust
toolchain) or the release installer above.
Usage
Setup — manage instances
# Register an ActiveCollab instance (interactive wizard prompts for missing fields)
ac setup add
ac setup add --name collab --url https://collab.example.com --email me@example.com
# Password is always entered hidden via a prompt — never passed as a flag.
# List configured instances (tokens never shown)
ac setup list
# Remove an instance and its cached tasks
ac setup remove --name collab
# Test connectivity to all (or one) configured instance
ac setup test
ac setup test --name collab
# Show the current display language
ac setup language
# Set the display language (persists to SQLite; survives across invocations)
ac setup language en
ac setup language pt_BR
get — fetch a task by URL or short form
ac get 665/75159
ac get https://collab.example.com/projects/665/tasks/75159
current — fetch the task from the current git branch
Branch must match (feature|hotfix|fix)/PROJECT_ID-TASK_ID (e.g. feature/665-75159).
ac current
mine — list open tasks assigned to you
ac mine
ac list # alias
When run in a terminal (TTY), mine opens an interactive arrow-key list of your
open tasks aggregated across all configured instances. Select a task to view its
detail or open/download its assets. When output is piped or redirected (non-TTY),
mine falls back to a plain table suitable for scripts.
Each task shows its estimate, the hours you logged on it this week (Monday to Sunday) and its total logged hours. An hour value the server does not return stays blank and never fails the list.
time report — export your hours for a period as XLSX or CSV
ac time report --period month|fortnight|week [--format xlsx|csv] [--instance NAME]
ac time report --start 01-08-2026 --end 30-08-2026 [--format xlsx|csv] [--instance NAME]
Writes your time records for the period to hours-report-<start>-<end>.<xlsx|csv>
in the current directory (dates as DD-MM-YYYY), overwriting a file of the same
name; the file is written to a temporary sibling and renamed, so a failed run
leaves an existing report intact. The period is either --start/--end
(inclusive, both required together) or --period, which resolves the current
period from today's local date: month is day 1 to the last day of the month,
fortnight is 1-15 or 16-last day, week is Monday to Sunday.
--period cannot be combined with --start/--end. The format defaults to xlsx.
The XLSX file has one sheet, Hours: Total hours for the period and the total
in row 1, the header Project, Activity, Hours, Date in row 3, then one row
per record sorted by date, project and record id; hours are numbers and dates are
Excel dates shown as dd/mm/yy. The CSV is ;-separated UTF-8 with a BOM (opens
in Excel) with the same rows: a Total hours for the period;<total> line, an
empty line, the header Project;Activity;Hours;Date, then the records, with a
decimal comma (1,5).
Run ac setup add again if the instance has no stored user id.
In ac browse, press H on any screen to open the same export as a modal:
pick Monthly, Biweekly, Weekly or Custom (Start/End as DD-MM-YYYY, Tab moves
between the fields) with ↑/↓ or j/k, toggle XLSX/CSV with f or ←/→, and
press Enter. It writes the same file as ac time report into the current
directory, for the open task's instance (otherwise the first configured one),
and shows the saved path and total; Esc closes it.
browse — interactive TUI
Arrow-key terminal browser for your open tasks. Navigate projects → tasks → task detail, then open/download the task's assets.
ac browse
ac browse --instance collab # required when >1 instance configured
The TUI uses ratatui for layout and crossterm for input, giving consistent mouse click, scroll, and keyboard behavior on Linux, macOS, and Windows. It shows a loading indicator during fetches and guards against duplicate in-flight refresh requests (single-flight).
The task detail view shows:
- Meta table — a two-column table listing Task, Project, Title, Status, Assignee, Start, Due, Estimate, and Logged.
- Description — the task body; falls back to
(no description)when empty. - Artifacts panel — lists each image / attachment / link as
[n] namewith its URL. - Comments — one panel per comment (author · date as the panel title).
The detail view scrolls vertically when content exceeds the screen. The TUI
adapts to terminal resize events and guards against too-small terminals without
crashing. The footer shows key-cap style hints ([key] action).
Each task you open is written to the local SQLite ticket_cache keyed by instance
name; re-opening the same task is instant and offline-tolerant. Press r inside
the detail view to bypass the cache and re-fetch from the API.
Key bindings
| Screen | Keys |
|---|---|
| Projects / Tasks lists (including mine) | ↑/↓ move · Enter select · r refresh · H hours report · q quit · Esc/b back (quits from the first screen) · Ctrl+C quit |
| Task detail | ↑/↓ or k/j move between comments · PgUp/PgDn page · r refresh · c new comment · t log time · e edit estimate · s toggle status · a assignee picker · l task list picker · H hours report · D download attachments · Esc/b back · q quit · Ctrl+C quit |
Bare-invocation shortcuts
ac 665/75159 # same as: ac get 665/75159
ac # same as: ac current (when branch matches)
Flags
| Flag | Applies to | Effect |
|---|---|---|
| --instance NAME | get, current, mine, browse | Force a specific configured instance (required when >
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
