{"id":"56628c36-c869-4f9d-873c-49e248e0b789","slug":"remorses-tuistory","name":"tuistory","description":"Playwright for terminal apps. Like tmux but designed for agents — virtual terminals you can\ntype into, press keys, wait for text, take snapshots, and screenshot as images.\n\ntuistory has **2 modes**:\n\n- **CLI** (`tuistory` command) — shell-based. Launch sessions, type, press keys, snapshot, screenshot.\n  Runs a background daemon that persists sessions across commands. Install globally or use `npx`/`bunx`.\n  **You MUST run `tuistory --help` before using the CLI** to see the latest commands and options.\n- **JS/TS API** (`import { launchTerminal } from 'tuistory'`) — programmatic. Use in vitest/bun:test\n  to write Playwright-style tests for CLIs and TUIs with inline snapshots.\n\nUse tuistory when you need to:\n- Write e2e tests for CLI/TUI apps (vitest, bun:test) with inline snapshots\n- Automate terminal interactions (launch a REPL, debugger, or TUI and drive it)\n- Screenshot terminal as images to send to users (Discord bots, agent UIs like kimaki/openclaw)\n- Reproduce bugs in interactive CLIs by scripting the exact steps\n- Explore TUI apps progressively with observe-act-observe loops","canonicalUrl":"https://xpersona.co/skill/remorses-tuistory","sourceUrl":"https://github.com/remorses/tuistory","homepage":null,"source":"GITHUB_OPENCLEW","vendor":{"slug":"remorses","label":"Remorses","url":"https://github.com/remorses/tuistory"},"protocols":["OPENCLEW"],"capabilities":[],"trustScore":null,"trustConfidence":"unknown","artifactCount":0,"benchmarkCount":0,"lastRelease":null,"freshnessAt":"2026-02-22T11:43:00.602Z","freshnessLabel":"Feb 22, 2026","securityReviewed":true,"openapiReady":true,"stats":[{"label":"Trust score","value":"Unknown"},{"label":"Compatibility","value":"OpenClaw"},{"label":"Freshness","value":"Feb 22, 2026"},{"label":"Vendor","value":"Remorses"},{"label":"Artifacts","value":"0"},{"label":"Benchmarks","value":"0"},{"label":"Last release","value":"Unpublished"}],"factsPreview":[{"factKey":"docs_crawl","category":"integration","label":"Crawlable docs","value":"6 indexed pages on the official domain","href":"https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar","sourceUrl":"https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar","sourceType":"search_document","confidence":"medium","observedAt":"2026-04-15T05:03:46.393Z","isPublic":true},{"factKey":"protocols","category":"compatibility","label":"Protocol compatibility","value":"OpenClaw","href":"https://xpersona.co/api/v1/agents/remorses-tuistory/contract","sourceUrl":"https://xpersona.co/api/v1/agents/remorses-tuistory/contract","sourceType":"contract","confidence":"medium","observedAt":"2026-02-24T19:43:57.803Z","isPublic":true},{"factKey":"auth_modes","category":"compatibility","label":"Auth modes","value":"api_key","href":"https://xpersona.co/api/v1/agents/remorses-tuistory/contract","sourceUrl":"https://xpersona.co/api/v1/agents/remorses-tuistory/contract","sourceType":"contract","confidence":"high","observedAt":"2026-02-24T19:43:57.803Z","isPublic":true},{"factKey":"schema_refs","category":"artifact","label":"Machine-readable schemas","value":"OpenAPI or schema references published","href":"https://github.com/remorses/tuistory#input","sourceUrl":"https://xpersona.co/api/v1/agents/remorses-tuistory/contract","sourceType":"contract","confidence":"high","observedAt":"2026-02-24T19:43:57.803Z","isPublic":true},{"factKey":"vendor","category":"vendor","label":"Vendor","value":"Remorses","href":"https://github.com/remorses/tuistory","sourceUrl":"https://github.com/remorses/tuistory","sourceType":"profile","confidence":"medium","observedAt":"2026-02-24T19:43:14.176Z","isPublic":true},{"factKey":"traction","category":"adoption","label":"Adoption signal","value":"215 GitHub stars","href":"https://github.com/remorses/tuistory","sourceUrl":"https://github.com/remorses/tuistory","sourceType":"profile","confidence":"medium","observedAt":"2026-02-24T19:43:14.176Z","isPublic":true},{"factKey":"handshake_status","category":"security","label":"Handshake status","value":"UNKNOWN","href":"https://xpersona.co/api/v1/agents/remorses-tuistory/trust","sourceUrl":"https://xpersona.co/api/v1/agents/remorses-tuistory/trust","sourceType":"trust","confidence":"medium","observedAt":null,"isPublic":true}],"highlights":["215 GitHub stars","Schema refs published","Trust evidence available"],"agentCard":{"name":"tuistory","description":"Playwright for terminal apps. Like tmux but designed for agents — virtual terminals you can\ntype into, press keys, wait for text, take snapshots, and screenshot as images.\n\ntuistory has **2 modes**:\n\n- **CLI** (`tuistory` command) — shell-based. Launch sessions, type, press keys, snapshot, screenshot.\n  Runs a background daemon that persists sessions across commands. Install globally or use `npx`/`bunx`.\n  **You MUST run `tuistory --help` before using the CLI** to see the latest commands and options.\n- **JS/TS API** (`import { launchTerminal } from 'tuistory'`) — programmatic. Use in vitest/bun:test\n  to write Playwright-style tests for CLIs and TUIs with inline snapshots.\n\nUse tuistory when you need to:\n- Write e2e tests for CLI/TUI apps (vitest, bun:test) with inline snapshots\n- Automate terminal interactions (launch a REPL, debugger, or TUI and drive it)\n- Screenshot terminal as images to send to users (Discord bots, agent UIs like kimaki/openclaw)\n- Reproduce bugs in interactive CLIs by scripting the exact steps\n- Explore TUI apps progressively with observe-act-observe loops","source":"GITHUB_OPENCLEW","sourceId":"github:1109925558","repository":"https://github.com/remorses/tuistory","documentation":"https://xpersona.co/skill/remorses-tuistory/agent/remorses-tuistory","protocols":["OPENCLEW"],"languages":["typescript"],"install":{"command":"git clone https://github.com/remorses/tuistory.git","ecosystem":"git"},"examples":[{"kind":"example","language":"bash","snippet":"# global\nbun add -g tuistory\nnpm install -g tuistory\n\n# or without installing\nnpx tuistory --help\nbunx tuistory --help"},{"kind":"example","language":"bash","snippet":"tuistory launch <command> -s <name> [--cols N] [--rows N] [--env KEY=VAL]\ntuistory -s <name> snapshot --trim\ntuistory -s <name> screenshot -o image.jpg --pixel-ratio 2\ntuistory -s <name> type \"text\"\ntuistory -s <name> press enter\ntuistory -s <name> press ctrl c\ntuistory -s <name> click \"Submit\"\ntuistory -s <name> wait \"pattern\" --timeout 10000\ntuistory -s <name> wait \"/regex/\" --timeout 10000\ntuistory -s <name> scroll down 5\ntuistory -s <name> resize 120 40\ntuistory -s <name> close\ntuistory sessions\ntuistory daemon-stop"}]}}