Skip to content
Diagnosis · Automation

beads

Dolt-powered issue tracker for multi-session work with dependencies and persistent memory across conversation compaction.

Connecting the steps of a workflow

Works with
ClaudeChatGPTGeminiClaude CodeCodexCursorCopilotGemini CLI
Setup
Upload one file
About a minute in Claude. One command in coding tools.
Contains
Instructions only
Text files — no scripts or programs.
Maintained
Last change 4 Oct 2026
On the repository’s main branch.

What it does

Beads - Persistent Task Memory for AI Agents

When your AI uses it

Use when work spans sessions, has blockers, or needs context recovery after compaction

You don’t need to name it. Ask for the job in your own words — your AI loads the skill when the request matches.

What it can touch

  • No script files in its folder

    Its folder holds text, not programs — but the instructions do tell your AI to run commands (see below).

    How we know

    Listed the 49 files in the skill’s folder on GitHub; none is a script or program.

  • Uses terminal commands

    It shows your AI commands to run. In a coding agent that means your terminal; in a chat app it usually can’t.

    How we know

    The SKILL.md contains shell code blocks.

  • Says which tools it uses

    It declares the tools it expects to be allowed: Read,Bash(bd:*)

    How we know

    The allowed-tools field in the SKILL.md front matter.

  • Downloads a script and runs it in one step, unread

    Code run this way does whatever the other server sends at that moment — what you can read today is not necessarily what runs.

    How we know

    resources/TROUBLESHOOTING.md line 57: “curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash”. Read 2026-10-05, commit f2eb56a.

    resources/TROUBLESHOOTING.md, line 57 ↗
  • 1 smaller thing worth knowing

    Downloads a script and runs it in one step, unread. Usually legitimate — listed so nothing is hidden.

    How we know

    Downloads a script and runs it in one step, unread — commands/version.md line 21. Read 2026-10-05, commit f2eb56a.

    commands/version.md, line 21 ↗
  • Recently maintained

    Its repository has had changes recently.

    How we know

    Last push to gastownhall/beads: 2026-10-04 (1 days before the scan).

Read automatically from the skill’s own files on GitHub on 5 Oct 2026. Launch7 does not run or manually review skills: this lists what the check saw, and nothing here means “safe”. How we check

Add it to your AI

Supported. Upload it once in Claude’s settings. Works on every plan, including Free.

  1. Built in your browser from the SKILL.md on GitHub — nothing passes through Launch7.

  2. In Claude, open Customize → Skills, press +, then Create skill → Upload a skill, and choose the .zip.

  3. Make sure code execution is switched on (Settings → Capabilities). Skills need it.

  4. Start a new chat and ask for the job in your own words — Claude picks the skill up when it fits.

How Claude does this: support.claude.com · checked 28 Sep 2026 · “Supported” means documented by the vendor; Launch7 has not run it end to end

More from gastownhall

All from this publisher →
  • beads-docs

    Project conventions for writing, editing, restructuring, or reviewing the beads user documentation — the Mintlify site under docs/.

    gastownhallInstructions only