dexhorthy/shannon

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.