Imported from HermannBjorgvin/Kirby (libs/terminal-tmux/AGENTS.md). Install upstream with npx skills add HermannBjorgvin/Kirby --skill terminal-tmux. Copyright stays with the author.

libs/terminal-tmux — tmux session backend

Name: terminal-tmux
Author: HermannBjorgvin

Optional backend over system tmux ≥ 2.0 (is-tmux-available.ts probes and gives a platform install hint). It knows nothing about Kirby: the caller supplies the session prefix and the isQualified seam.

vitest.setup.ts pins a scratch socket dir (TMUX_TMPDIR) and drops $TMUX before any spec loads; assertScratchTmuxSocket fails the run if either is lost. $TMUX names a socket outright and beats TMUX_TMPDIR, so a suite started inside a tmux session (how Kirby's own agents run) otherwise reaches the developer's server, where the kirby-* names are their live agents and these suites kill by name pattern.
Never tmux kill-server. A scratch server exits with its last session.
-e HOME / -e PATH per session needs tmux ≥ 3.2; a server keeps the env it was started with, and a stale server on the default socket otherwise kills every agent at launch. attach-session -f ignore-size also needs 3.2, above the floor.
sanitize-tmux-session-name.ts: . and : become -, with a length cap. Terminal names (kirby-term-…) are shaped to pass it unchanged.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

{ "ocm": "1", "id": "hermannbjorgvin-kirby-terminal-tmux", "kind": "skill", "name": "terminal-tmux", "description": "Optional backend over system tmux ≥ 2.0 (`is-tmux-available.ts` probes and gives a platform install hint). It knows nothing about Kirby: the caller supplies the session prefix and the `isQualified` seam.", "publisher": "HermannBjorgvin", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Optional backend over system tmux ≥ 2.0 (`is-tmux-available.ts` probes and gives a platform install hint). It knows nothing about Kirby: the caller supplies the session prefix and the `isQualified` seam." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/HermannBjorgvin/Kirby", "path": "libs/terminal-tmux/AGENTS.md", "ref": "64c17286721d8c304152ce9b9c9e241d6799fbe1", "url": "https://github.com/HermannBjorgvin/Kirby/blob/64c17286721d8c304152ce9b9c9e241d6799fbe1/libs/terminal-tmux/AGENTS.md", "key": "HermannBjorgvin/Kirby/libs/terminal-tmux/AGENTS.md" } }, "instructions": "# libs/terminal-tmux — tmux session backend\n\nOptional backend over system tmux ≥ 2.0 (`is-tmux-available.ts` probes and\ngives a platform install hint). It knows nothing about Kirby: the caller\nsupplies the session prefix and the `isQualified` seam.\n\n- `vitest.setup.ts` pins a scratch socket dir (`TMUX_TMPDIR`) and drops\n `$TMUX` before any spec loads; `assertScratchTmuxSocket` fails the run if\n either is lost. `$TMUX` names a socket outright and beats `TMUX_TMPDIR`, so\n a suite started inside a tmux session (how Kirby's own agents run) otherwise\n reaches the developer's server, where the `", "cost": { "context_tokens": 286 } }

terminal-tmux

About

libs/terminal-tmux — tmux session backend

Use it

Manifest

Reviews