what is shannon fr?

dexhorthy/shannon — explained in plain English

Analysis updated 2026-05-18

★ 204TypeScriptAudience · developerComplexity · 3/5Setup · moderate

vibe map

mindmap
  root((repo))
    What it does
      Automates Claude Code sessions
      Runs sessions inside tmux
      Captures structured output
    Tech stack
      TypeScript
      Bun
      tmux
    Use cases
      Scripted Claude workflows
      Custom tool integration
      Chaining multiple prompts
    Audience
      Developers building agents
      CLI tool builders
    Output formats
      Streaming JSON
      Single JSON object
      Plain text

mindmap root((repo)) What it does Automates Claude Code sessions Runs sessions inside tmux Captures structured output Tech stack TypeScript Bun tmux Use cases Scripted Claude workflows Custom tool integration Chaining multiple prompts Audience Developers building agents CLI tool builders Output formats Streaming JSON Single JSON object Plain text

what do people make with this?

VIBE 1

Automate Claude Code tasks from a script instead of the interactive terminal.

VIBE 2

Build a custom tool or agent that chains multiple Claude prompts together.

VIBE 3

Capture Claude's responses as structured JSON for further processing.

VIBE 4

Reuse an existing Claude login and session state without calling the API directly.

what's the stack?

TypeScriptBuntmux

how it stacks up fr

	dexhorthy/shannon	placenl2026/best-of-algorithmic-trading	yeachan-heo/gajae-code
Stars	204	204	203
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	moderate	easy	moderate
Complexity	3/5	1/5	3/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires the Claude CLI, tmux, and Bun installed, plus an existing Claude login.

in plain english

Shannon is a command-line tool and code library that lets you drive an interactive Claude Code session programmatically and capture the output as structured data. Normally, Claude Code is designed for interactive use in a terminal, you type prompts and read responses. Shannon solves the problem of using Claude Code from scripts, automated workflows, or your own applications without calling the Anthropic API directly. It works by starting a real Claude session inside tmux, a tool for managing terminal sessions in the background, then sending your prompt to that session and reading Claude's on-disk transcript file to capture the responses. Because it drives the actual Claude CLI rather than calling the API itself, it reuses your existing Claude login and any session state or context that comes with it. You would use this if you want to automate Claude Code tasks from a script, integrate Claude into a custom tool, or build agents that chain multiple Claude prompts together while receiving structured output. It outputs responses in streaming line-by-line JSON format, single-object JSON, or plain text. It can be used as a command-line tool or imported as a library. It requires the Claude CLI, tmux, and Bun to be installed on your machine. Built with TypeScript.

prompts (copy fr)

prompt 1

Explain how Shannon starts and drives a Claude Code session inside tmux.

prompt 2

Walk me through installing the Claude CLI, tmux, and Bun so Shannon can run.

prompt 3

Show me how to use Shannon as a library to capture Claude's response as structured JSON.

prompt 4

What is the difference between Shannon's streaming JSON output and its single-object JSON output?

prompt 5

Help me design a script that chains several Claude prompts together using Shannon.

Frequently asked questions