Use this skill when an operator needs a self-hosted control plane for long-running coding-agent sessions that must be visible from a browser or mobile device while still running on the operator’s own machine or server. Codeman wraps supported terminal agents in persistent sessions, exposes a web dashboard, and provides APIs for session creation, input delivery, output reads, events, and access controls.

## What the agent/operator does

1. Install Codeman and confirm the target coding-agent CLIs are available on the host.
2. Start the Codeman web server with an explicit bind and authentication posture appropriate for the network.
3. Create named cases or sessions for Claude Code, Codex, OpenCode, Gemini CLI, or configured terminal agents.
4. Watch live terminal output, subagent activity, and session state from the dashboard without manually attaching to each terminal.
5. Send idempotent prompts or commands into selected sessions through the UI or API.
6. Use the event stream and output endpoints to build supervised automation around session status, logs, and blockers.
7. Apply the upstream security guidance before exposing the dashboard beyond loopback.

## When to invoke

Invoke this instead of using each coding-agent product normally when work spans multiple persistent sessions, needs browser or mobile supervision, or requires a self-hosted dashboard and API around terminal agents. It is strongest for operators who deliberately want local ownership of session state and network exposure choices.

## Scope boundary

This is not a generic web dashboard, remote shell, model provider, or autonomous coding framework. Keep the workflow scoped to supervising and controlling self-hosted terminal coding-agent sessions through Codeman. Because the dashboard can become a remote-code-execution surface, do not present it as safe to expose publicly without authentication, host allowlists, and the documented permission-mode choices.

## Requirements

– Node.js 22 or newer.
– Codeman installed as the aicodeman package or from the upstream repository.
– One or more supported terminal coding-agent CLIs, such as Claude Code, Codex, OpenCode, or Gemini CLI.
– A local or server environment where tmux/terminal-backed sessions can run.
– Explicit authentication and network-binding decisions before remote access.

## Installation

Install from npm or the upstream install path, then start the web dashboard:

npm install -g aicodeman
codeman web

For remote access, follow the upstream security architecture and set CODEMAN_PASSWORD before binding beyond loopback or using a tunnel.

## Verification notes

Source metadata was verified from the exact GitHub repository, npm registry, package.json, and upstream README. As of this intake run, Ark0N/Codeman had 500 GitHub stars, 70 forks, an MIT license, same-day push activity, and the aicodeman npm package showed 1,923 downloads in the last week. Upstream documents self-hosted session management, Claude Code/OpenCode/Codex/Gemini CLI support, dashboard control, stable API aliases, event streams, host-header and Origin checks, authentication, and configurable permission modes.