davorian

Factotum OSS — Communication skill for Claude Code

Communication community

A personal cockpit for cross-client dev work: ticket board, PR autopilot, chat panels, a terminal drawer with persistent Claude Code sessions, and batch-action skills.

How to install Factotum OSS

This entry records only its repository, not the path inside it, so there is no exact command to give. Open davorian/factotum-oss and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Factotum OSS does

A personal cockpit for cross-client dev work: ticket board, PR autopilot, chat panels, a terminal drawer with persistent Claude Code sessions, and batch-action skills. Electron app or browser via HTTP bridge.

Alternatives in Communication

HolaOS — Open-source agentic workspace enterprises can make their own 10.9k ★
Claude Agent Desktop — Electron desktop application for agentic chat with the Claude Agent SDK 196 ★
Google Workspace Skills — Suite of Google Workspace integrations: Gmail, Calendar, Chat, Docs, Sheets, Slides, and Drive with cross-plat 162 ★

README

factotum

A personal cockpit for cross-client dev work — ticket board, PR autopilot, chat panels, integrated terminal drawer with persistent claude sessions, and batch-action skills. Runs as an Electron desktop app OR in a plain browser via an HTTP bridge.

Requirements

Node.js — no engines field is declared in package.json; Node 20+ recommended (development targets modern ESM + node:* builtins). Check with node -v before installing.
OS packages for building node-pty (needed for the terminal drawer). Standard node-pty requirements — see the node-pty docs for the authoritative list. Typically:
- Linux/WSL: sudo apt-get install -y build-essential python3
- macOS: Xcode Command Line Tools (xcode-select --install)
- Windows: Visual Studio Build Tools with C++ workload
gh CLI for GitHub PR/board features — install. factotum shells out to gh for PR list/view/comment operations.
Optional: claude CLI on $PATH — the terminal drawer's Resume button on dead tabs spawns claude --resume in the tab's original cwd.

Install

git clone https://github.com/davorian/factotum-oss.git
cd factotum
npm install

If `node-pty` fails to build on first install, install the OS build deps above then re-run `npm rebuild node-pty`.

First-run configuration

factotum reads its user config from `~/.factotum/`. None of these files ship with the repo — create them per-user. Files containing tokens should be mode 600.

`~/.factotum/clients.json` — client identities

Defines the label + color of each client, the org→client mapping for GitHub repos, the default cwd for terminal spawns, per-org PR-review skill lists, the skill names the one-click actions and autopilot loop invoke, an optional CI diagnostic playbook, and any read-only Metabase environments for the Data tab. **Without this file, all clients rend