SkillAgentSearch skills...

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-cli

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

74/100

Supported Platforms

Claude Code
Claude Desktop
OpenAI Codex

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.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
3/20
Freshness
15/15

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.

SkillScoreStarsUpdatedFormat
active-collab-cli (this skill)by ejklock7432d agoMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.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.

active-collab-cli — ActiveCollab CLI, terminal UI and MCP server

CI Latest release npm: active-collab-agent License: MIT

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 log and ac time report: log hours, and export a period's hours as XLSX or CSV.
  • --json on 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

The ac browse task-detail view, rendered with fictional demo data

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] name with 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

View on GitHub
GitHub Stars3
CategoryDevelopment
Updated2d ago
Forks0

Languages

Rust

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low
active-collab-cli — MCP Server: Install & Safety Check | SkillAgent