hivecommons

Pluk — AI skill for Claude Code

AI community

Lightweight pub-sub event streaming for tmux sessions running AI coding agents.

How to install Pluk

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

What Pluk does

Lightweight pub-sub event streaming for tmux sessions running AI coding agents.

Alternatives in AI

Nodeterm — Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as dragga 1.3k ★
Botmux — Bridge Feishu/Lark to AI coding CLIs — Claude Code, Codex, Gemini, OpenCode… every DM, group or topic spawns i 1.2k ★
Skills Manager — A lightweight desktop app to manage, sync, and organize AI agent skills across 15+ coding tools — Cursor, Clau 813 ★

README

Pluk

[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)

Pluk classifies, subscribes to, and reacts to JSONL event streams from AI coding agent terminals.

Install

Requirements:

Node.js 22 or newer
tmux (attach, send and watch --capture drive tmux sessions)

npm install -g @hivecommons/pluk

Optional: install [rationguard](https://www.npmjs.com/package/@hivecommons/rationguard) only if you want `pluk attach --rationguard`. pluk never fetches it for you; without it on `PATH` (or `--rationguard-bin`), `--rationguard` exits with an error.

npm install -g @hivecommons/rationguard

Quick Start

One command to create a tmux session, start an AI CLI, and attach pluk event capture:

pluk attach my-agent --cli=claude

This does three things:

Creates a tmux session named my-agent
Attaches pluk via tmux pipe-pane to classify all terminal output, including start-up output
Starts claude inside it

To also wire up rationguard for real-time excuse detection (requires rationguard to be installed; see [Install](#install)):

pluk attach my-agent --cli=claude --rationguard --rebuttal=send

This additionally starts `rationguard watch` to detect rationalizations and send rebuttals back.

To attach to an existing tmux session (e.g., one already running goose):

pluk attach my-agent --cli=goose

**Note:** When attaching to an existing session with `--dangerous`, the CLI may not have permission-skip enabled (the flag only applies when creating a new session). pluk will print a warning with the command to restart the CLI with the right flag. Likewise, `--command`, `--cli-args` and `--dir` only apply when creating a new session; pluk warns when they are passed to an existing one.

By default, pluk attaches to the tmux session. Without `--rationguard`, it attaches in