Agent skill

Tuistory

by remorses in remorses/tuistory

tmux for AI agents. An agent skill from remorses/tuistory.

No licenceAuto-check passedTesting & QA

Install Tuistory

skills CLI
$ npx skills add remorses/tuistory --skill tuistory -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install remorses/tuistory tuistory --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/remorses/tuistory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tuistory .claude/skills/tuistory && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tuistory
GitHub stars
367
Token cost
~2.4k tokens
SKILL.md length
826 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

tmux for AI agents. An agent skill from remorses/tuistory.

  • Works in 3 steps: Add tuistory to the project's dev… → Wrap dev and long-running commands with… → Add a dev server section to the…
  • Tasks that involve Browser testing
  • SKILL.md covers Dev script pattern, Dev script convention for…, Setting up a project to use… and Passthrough mode (traforo,…, plus 2 more sections
  • Calls pnpm, bun and curl

What it does

Tuistory is an agent skill from remorses/tuistory. tmux for AI agents. Run dev servers and TUIs in named background sessions that agents can read, wait on, snapshot, and type into. Replaces tmux with reactive waiting instead of blind sleep. Projects wrap their dev script with tuistory ("dev": "tuistory -- next dev") so agents get a background session and humans get auto-attached. Use tuistory when you need to: - Run background dev servers or long-lived processes - Control interactive CLIs and TUIs (type, press keys, click, wait, snapshot) - Write Playwright-style…

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Browser testing. It works with tmux, Playwright and pnpm. The repository describes itself as: TMUX for agents. let agents control & test terminal user interfaces. Like Playwright & agent-browser but for TUIs.

When your agent uses it

  • Tasks that involve Browser testing

Example prompts

  • “tuistory -- next dev”
  • “/tuistory”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Add tuistory to the project's dev dependencies (or root devDependencies in a monorepo so the binary resolves everywhere)
  2. Wrap dev and long-running commands with tuistory -- in package.json scripts. Keep tuistory -- on the outside of wrappers like sigillo run…
  3. Add a dev server section to the project's AGENTS.md so other agents know how to use it. Use pnpm dev for pnpm projects and bun dev for bun…

What it can do on your machine

Read from SKILL.md and the folder at commit 363cbd2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm
    • bun
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm and curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tuistory loads about 2.4k tokens when it runs. Until then it costs about 168 tokens; SKILL.md has 826 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~168
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 826 words (~2,419 tokens).

“Run dev servers and terminal commands that AI agents can read, wait on, and type into. Wrap any command in a named background session. Humans get auto-attached; agents get a session they can inspect with read, snapshot, wait, and type.”

— opening of SKILL.md by remorses
name
tuistory

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/tuistory of remorses/tuistory.

Open the folder on GitHubat commit 363cbd2

Compare with similar skills

Tuistory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tuistory compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tuistory this skillremorses/tuistory367—~2.4kAutomated safety check: PassNone
Ckeditor5 TestingTriliumNext/Trilium38k—~3.3kAutomated safety check: PassAGPL-3.0
Agent Integration ReplayComfy-Org/ComfyUI_frontend2.1k—~805Automated safety check: NotesGPL-3.0
UI Previewtingly-dev/tingly-box351—~2kAutomated safety check: NotesMPL-2.0
E2E VerificationChorus-AIDLC/Chorus1.2k—~1.5kAutomated safety check: NotesAGPL-3.0
E2E PlaywrightAsvarox/allkaraoke261—~876Automated safety check: PassNone

Similar skills

  • Ckeditor5 Testing

    TriliumNext/Trilium

    Testing CKEditor 5 plugins in the Trilium monorepo. An agent skill from TriliumNext/Trilium.

    38k GitHub stars~3.3k tokensUpdated today
    Testing & QAAuto-check passed
  • Agent Integration Replay

    Comfy-Org/ComfyUI_frontend

    Replay recorded agent conversations as Playwright tests against the real chat panel and canvas.

    2.1k GitHub stars~805 tokensUpdated today
    Testing & QAAuto-check: notes
  • UI Preview

    tingly-dev/tingly-box

    Capture headless-Chrome screenshots of the tingly-box frontend (running locally in mock mode) so frontend changes can be visually verified in environments without a real browser.

    351 GitHub stars~2k tokensUpdated today
    Testing & QAAuto-check: notes
  • E2E Verification

    Chorus-AIDLC/Chorus

    A skill your agent uses when manually verifying a Chorus frontend change in a real browser — finding local login credentials, driving the running dev server with the Playwright MCP, logging in…

    1.2k GitHub stars~1.5k tokensUpdated today
    Testing & QAAuto-check: notes
  • E2E Playwright

    Asvarox/allkaraoke

    Run, write, and debug Playwright E2E tests for this project.

    261 GitHub stars~876 tokensUpdated today
    Testing & QAAuto-check passed
  • Ha Frontend Testing

    home-assistant/frontend

    Home Assistant frontend testing and validation workflow. An agent skill from home-assistant/frontend.

    5.7k GitHub stars~1.7k tokensUpdated today
    Testing & QAAuto-check passed

Categories

Questions about Tuistory

What does Tuistory do?

tmux for AI agents. An agent skill from remorses/tuistory. Tuistory is an agent skill from remorses/tuistory. tmux for AI agents.

When should I use Tuistory?

Tuistory fits situations like: tasks that involve Browser testing.

How do I install Tuistory in Claude Code?

Run `npx skills add remorses/tuistory --skill tuistory -a claude-code`. Or copy the skill folder (skills/tuistory in remorses/tuistory) into .claude/skills/tuistory in your project. Claude Code loads it when a task matches its description.

How do I install Tuistory in Codex?

Run `npx skills add remorses/tuistory --skill tuistory -a codex`. Or copy the skill folder (skills/tuistory in remorses/tuistory) into .agents/skills/tuistory in your project. Codex loads it when a task matches its description.

Can I use Tuistory in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add remorses/tuistory --skill tuistory -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tuistory, .gemini/skills/tuistory, .github/skills/tuistory and .opencode/skills/tuistory in your project.

What does Tuistory need to run?

Going by SKILL.md and its folder, Tuistory needs the command-line tools its instructions call (pnpm, bun and curl).

Does Tuistory access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Tuistory safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tuistory use?

No licence was found for Tuistory or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Tuistory use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tuistory?

Skills that share tags, products or a category with Tuistory: Ckeditor5 Testing (TriliumNext/Trilium, 38k stars), Agent Integration Replay (Comfy-Org/ComfyUI_frontend, 2.1k stars), UI Preview (tingly-dev/tingly-box, 351 stars) and E2E Verification (Chorus-AIDLC/Chorus, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tuistory?

remorses (a GitHub user) maintains it in remorses/tuistory, which has 367 GitHub stars. The repository was last updated on August 21, 2026.

Source: remorses/tuistory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.