A seamless Claude AI integration for the Julia REPL

ClaudeREPL.jl brings Claude AI directly into your Julia workflow. Chat with Claude without leaving your REPL environment, complete with persistent history and rich markdown formatting.

• 🚀 One-key access: Press ) to instantly enter Claude mode
• 📚 Persistent history: Navigate previous conversations with arrow keys across Julia sessions
• 🎨 Rich formatting: Markdown rendering for code blocks, lists, and formatting
• 🔄 Seamless integration: Native Julia REPL experience with automatic initialization
• 🛡️ Robust error handling: Graceful handling of network issues and API errors
• ⚡ Streaming responses: Real-time response display as Claude types

You'll need the Claude Code CLI installed and authenticated:

# Install Claude Code CLI (see https://docs.anthropic.com/en/docs/claude-code)
# Then authenticate
claude auth login

# Clone and install
git clone https://github.com/terasakisatoshi/ClaudeREPL.jl.git
cd ClaudeREPL.jl
julia --project -e 'using Pkg; Pkg.instantiate()'

julia> using ClaudeREPL
Claude REPL mode initialized. Press ')' to enter and backspace to exit.

julia> )
claude> What's the difference between map and broadcast in Julia?

# Claude responds with detailed explanation...

claude> Can you show me an example of metaprogramming?

# Use ↑ arrow to navigate back to previous questions
# Press backspace on empty line to return to Julia REPL

Method 1: Quick key (recommended)

julia> )    # Press ')' at the start of any line
claude> 

Method 2: Function call

julia> claude_mode!()
claude> 

• ↑/↓ Arrow keys: Navigate through command history
• Ctrl+P/Ctrl+N: Alternative history navigation
• Backspace (on empty line): Exit to Julia REPL
• Type exit: Exit to Julia REPL
• Type help: Show help message

Your conversations are automatically saved and restored:

• Persistent storage: History saved to DEPOT_PATH[1]/config/claude_repl_history.txt
• Cross-session: Access previous conversations after restarting Julia
• Smart deduplication: Consecutive identical commands are filtered out
• Reasonable limits: Keeps last 100 commands for optimal performance

History is stored in your Julia depot:

# Check your history file location
julia> using ClaudeREPL
julia> println(ClaudeREPL.CLAUDE_HISTORY_FILE)

If auto-initialization fails:

julia> claude_repl_init()

claude> help

Shows available commands and keyboard shortcuts.

ClaudeREPL.jl consists of three main components:

• Package exports and automatic initialization
• Integration with Julia's module system

• Custom REPL mode with native Julia integration
• Manual history system with persistent storage
• Key binding management and safe error handling

• Streaming interface to ClaudeCodeSDK
• Markdown response processing and display
• Robust error handling for API communication

julia --project=. -e "using Pkg; Pkg.test()"

• Julia: 1.10+
• ClaudeCodeSDK.jl: Core Claude integration
• Standard Library: REPL, Markdown

Contributions are welcome! Feel free to:

• Report bugs and request features via GitHub Issues
• Submit pull requests for improvements
• Share usage examples and workflows

MIT License - see LICENSE file for details.

• Satoshi Terasaki
• Claude Code

Built with ❤️ for the Julia community