ClaudeCast

Discover, resume, and automate Claude Code sessions
Deep full-text search, one-keystroke resume, agentic loops, usage analytics, and quick prompts. Bridges Claude Code's agentic CLI with Raycast's instant-access UI.

---

Features

Launch Project

Fast project switching for Claude Code. Browse all your projects with favorites, recents, and session counts.

• Discovers projects from Claude Code history
• Integrates with VS Code recent workspaces
• Launch new session or continue existing
• Open in VS Code or Finder
• Manage favorites

Deep Search Sessions

Full-text search across every Claude Code conversation on disk.

• Streams JSONL files incrementally so results appear as they are found
• Match snippets show ~15 words of context around the query, with the match bolded
• Debounced search with cancellation when the query changes
• Resume, fork, or delete any matched session in place
• Cleans <local-command-*> and short slash-only prompts out of the result list

Browse Sessions

Find and resume any Claude Code conversation across all projects.

• Filter by project
• Inline conversation preview with the most recent 20 messages and a "Showing last N of M messages" notice for long sessions
• Resume, fork, or delete sessions
• See cost and token usage per session
• Restores the original permission mode and model on resume

Agentic Workflows

Curated collection of production-tested prompts with variable substitution.

Categories:

• Planning & Architecture
• Test-Driven Development
• Code Review & Security
• Refactoring
• Debugging
• Documentation
• Advanced Multi-Step Workflows

Ralph Loop

Autonomous agentic execution that breaks down complex tasks and runs them with fresh context per iteration.

How it works:

1. Describe your task and requirements
2. Claude creates a plan with atomic, self-contained tasks
3. Each task runs in a fresh Claude session (~176K tokens available)
4. Watch Claude work with full TUI visibility
5. Resume anytime if max iterations reached

Features:

• Fresh context per task prevents degradation at high token counts
• Full terminal UI visibility during execution
• Graceful stop with touch .ralph/stop
• Resume with bash .ralph/resume.sh 10

Git Actions

Git-aware Claude Code workflows for common tasks.

• Review staged changes
• Generate commit messages
• Explain recent diffs
• Review unstaged changes
• Summarize branch changes

Ask Claude Code

Quick prompt with automatic context capture from VS Code. Select text anywhere, hit the hotkey, and get answers without opening a terminal.

• Auto-detects current project from VS Code
• Captures selected text and clipboard
• Shows git branch context
• Supports all Claude models (Sonnet, Opus, Haiku)
• Continue conversation in terminal

Transform Selection

One-keystroke code transformations from any app.

• Explain code
• Explain regex
• Find bugs
• Convert to another language
• Add TypeScript types
• Optimize performance
• Add comments
• Write tests

Quick Continue

One keystroke to continue your last Claude Code session. No UI - just launches directly.

Menu Bar Monitor

Real-time Claude Code status in your menu bar.

• Active session indicator
• Today's cost and session count
• Quick access to all commands

Usage Dashboard

Detailed cost and usage metrics with a live SVG bar chart.

• Range tabs adapt the chart granularity: Today/Week (daily bars), Month (weekly), All Time (up to 12 monthly bars)
• Per-range totals, token breakdown (input, output, cache read, cache write)
• Top projects as colored tags; "Cost by Project" and "Top Sessions" tables
• Streaming-chunk dedup so cumulative usage reports match Anthropic's actual billing
• Per-model pricing including Opus 4.7, Opus 4.1, and the Sonnet 200K-token tier

Installation

Prerequisites

1. Claude Code CLI: Install the Claude Code CLI tool

   npm install -g @anthropic-ai/claude-code
   

2. Raycast: Download from raycast.com

Install Extension

1. Clone this repository or download the extension
2. Open Raycast and search for "Import Extension"
3. Select the claude-cast directory
4. Or run in development mode:

   cd claude-cast
   npm install
   npm run dev
   

Setup

OAuth Token (Required for API Features)

Some features (Ask Claude Code, Transform Selection, Git Actions) require an OAuth token to work in Raycast's sandboxed environment:

1. Generate a long-lived OAuth token:

   claude setup-token
   

2. Copy the token and add it to ClaudeCast preferences:

   • Open Raycast → Search "ClaudeCast" → Press ⌘,
   • Paste the token in the "OAuth Token" field

Configuration

Open Raycast preferences and configure ClaudeCast:

• Default Model: Choose between Sonnet (balanced), Opus (most capable), or Haiku (fastest)
• Terminal Application: Pick from Terminal, iTerm, Warp, kitty, Ghostty, or cmux. Each launcher uses the terminal's native AppleScript or CLI for reliable launches.
• Open In: Choose New Window or New Tab. Honored by Terminal, iTerm, kitty, Ghostty, and cmux. Warp always opens a new window.
• Claude Code Path: Optionally specify a custom path to the Claude CLI binary
• Anthropic API Key / OAuth Token: For API features (Ask Claude Code, Git Actions, Transform Selection, Agentic Workflows). Either preference works. The auth gate also accepts ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, or CLAUDE_CODE_OAUTH_TOKEN env vars, or existing claude auth login credentials.

Usage

Keyboard Shortcuts (Suggested)

Set these in Raycast preferences:

Command	Suggested Shortcut
Ask Claude Code	⌘⇧C
Quick Continue	⌘⌥R
Browse Sessions	⌘⌥S
Launch Project	⌘⌥L
Git Actions	⌘⇧G
Agentic Workflows	⌘⌥P
Transform Selection	⌘⇧T

Tips

1. Context Capture: For best results, select code in VS Code before triggering Ask Claude Code
2. Project Detection: Keep VS Code open in your project for automatic project detection
3. Quick Continue: Use this when you step away and want to resume your last conversation
4. Agentic Workflows: Start with built-in prompts, then create custom ones for your workflows
5. Git Actions: Stage your changes first, then use "Write Commit Message" for AI-generated commits

Development

# Install dependencies
npm install

# Start development
npm run dev

# Build for production
npm run build

# Lint code
npm run lint

# Fix lint issues
npm run fix-lint

Project Structure

claude-cast/
├── src/
│   ├── ask-claude.tsx            # Quick Prompt command
│   ├── browse-sessions.tsx       # Session Browser
│   ├── deep-search-sessions.tsx  # Full-text Deep Search
│   ├── launch-project.tsx        # Project Launcher
│   ├── quick-continue.tsx        # Quick Continue
│   ├── git-actions.tsx           # Git Actions
│   ├── prompt-library.tsx        # Agentic Workflows
│   ├── transform-selection.tsx   # Transform Selection
│   ├── menu-bar-monitor.tsx      # Menu Bar Monitor
│   ├── usage-dashboard.tsx       # Usage Dashboard
│   └── lib/
│       ├── claude-cli.ts         # Claude CLI integration and auth gate
│       ├── session-parser.ts     # JSONL session parsing and streaming usage scanner
│       ├── project-discovery.ts  # Project detection
│       ├── context-capture.ts    # VS Code context capture
│       ├── terminal.ts           # Terminal launch utilities (Terminal, iTerm, Warp, kitty, Ghostty, cmux)
│       ├── svg-chart.ts          # SVG bar chart for the Usage Dashboard
│       ├── prompts.ts            # Built-in prompts
│       └── usage-stats.ts        # Usage statistics
├── assets/
│   └── command-icon.png        # Extension icon
├── package.json
├── tsconfig.json
└── README.md

License

MIT

Contributing

Contributions welcome! Please read the contributing guidelines first.

Credits

Built with Raycast and Claude Code.