dexhorthy

dexhorthy / shannon

Public

alternative to claude -p that lifecycles interactive sessions in tmux

48
3
89% credibility
Found May 14, 2026 at 49 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Shannon is a tool and library that automates sending prompts to an interactive AI coding CLI session and streams back structured conversation transcripts including responses, tools used, and usage details.

How It Works

1
🔍 Discover Shannon

You hear about Shannon, a handy sidekick that makes chatting with your AI coding helper smarter and more organized.

2
📥 Get Shannon ready

You bring Shannon onto your computer alongside your AI coding buddy, so they can work together seamlessly.

3
🔑 Link your AI account

You make sure your AI coding helper is signed in and ready to receive messages.

4
💬 Ask your first question

You send a question or instruction to the AI through Shannon, and it feels like having a conversation with a smart friend.

5
📈 See responses roll in

Shannon captures every thought, answer, and detail from the AI, delivering them in a clear, flowing stream you can easily follow.

6
🔄 Keep the chat going

You send more questions or build on the conversation, with Shannon keeping everything neat and structured.

🎉 Unlock smart coding magic

Your coding ideas come alive with organized AI insights, costs, and results, making your projects faster and better.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 49 to 48 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is shannon?

Shannon is a TypeScript CLI and SDK that wraps the interactive Claude Code tool, spinning up real sessions in tmux to send prompts and stream back structured JSON output. As an open-source alternative Claude code CLI, it reads transcripts from disk instead of hitting the Anthropic API directly, giving you reliable JSONL, single JSON arrays, or plain text responses without managing sessions manually. Developers get a drop-in replacement for claude -p with Bun-powered scripting and async iterables for easy integration.

Why is it gaining traction?

It stands out as a free alternative Claude AI CLI for programmatic access to Claude's full interactive mode, including tools like Bash, Edit, and WebSearch, all via tmux lifecycle management. The SDK's query() function delivers real-time streams with costs, durations, and hook events, plus an agent SDK facade for compatibility—perfect for chaining into GitHub Actions or custom agents without Copilot's limits. Low overhead and verbose logging make debugging workflows painless.

Who should use this?

Backend devs scripting AI-assisted code reviews or task automation with Claude Code. Agent builders needing a Claude Shannon GitHub bridge for multi-turn sessions in VSCode extensions or desktops. Teams seeking an alternative GitHub Copilot free tier for structured outputs in CI/CD pipelines.

Verdict

Try it if you're deep into Claude Code—solid docs and CLI make it production-ready for niches, despite 48 stars and a 0.9% credibility score signaling early maturity. Pair with tests for reliability in agents.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.