Skip to content

Releases: BitBrujo/rigger

Rigger 1.0.4

10 Dec 07:53
@github-actions github-actions
v1.0.4
f9ea87e

Choose a tag to compare

View all tags
Rigger 1.0.4 Latest
Latest

Release Notes - v1.0.4

Release Date: 2025-12-10

Changes since: v1.0.3

Summary

  • 13 commits
  • 2 contributors

✨ Features

  • add session history viewer modal (56b7033)

🧹 Chores

  • bump version to 1.0.4 (f9ea87e)
  • ([- Overv](../../commit/- Overview tab: timestamps, metrics (cost, tokens, turns), tools used))
  • ([- Messa](../../commit/- Messages tab: full conversation history in chat-like format))
  • ([- Confi](../../commit/- Configuration tab: config snapshot used for the session))
  • ([- Timel](../../commit/- Timeline tab: visual timeline of session lifecycle events))
  • ([🤖 Gene](../../commit/🤖 Generated with Claude Code))
  • ([Co-Auth](../../commit/Co-Authored-By: Claude noreply@anthropic.com))
  • display tool descriptions inline instead of tooltip (fc94f3c)
  • ([making ](../../commit/making them immediately visible without requiring hover interaction.))
  • ([🤖 Gene](../../commit/🤖 Generated with Claude Code))
  • ([Co-Auth](../../commit/Co-Authored-By: Claude noreply@anthropic.com))
  • Delete RELEASE_NOTES_v1.0.0.md (13537b7)

Contributors

  • bitbrujo

Installation

git clone https://github.com/yourusername/rigger.git
cd rigger
git checkout v1.0.4

Upgrading from v1.0.3

  1. Backup your database
  2. Pull latest changes: git pull && git checkout v1.0.4
  3. Rebuild containers: docker-compose down && docker-compose up -d --build
  4. Update frontend: npm install && npm run dev

Full Changelog: v1.0.3...v1.0.4

Assets 6
Loading

Rigger 1.0.3

04 Dec 13:23
@github-actions github-actions
v1.0.3
9db9fe3

Choose a tag to compare

View all tags
Rigger 1.0.3

Release Notes - v1.0.3

Release Date: 2025-12-04

Changes since: v1.0.2

Summary

  • 7 commits
  • 2 contributors

🧹 Chores

Contributors

  • bitbrujo

Installation

git clone https://github.com/yourusername/rigger.git
cd rigger
git checkout v1.0.3

Upgrading from v1.0.2

  1. Backup your database
  2. Pull latest changes: git pull && git checkout v1.0.3
  3. Rebuild containers: docker-compose down && docker-compose up -d --build
  4. Update frontend: npm install && npm run dev

Full Changelog: v1.0.2...v1.0.3

Loading

Rigger 1.0.2

03 Dec 09:25
@github-actions github-actions
v1.0.2
d8b5c42

Choose a tag to compare

View all tags
Rigger 1.0.2

Release Notes - v1.0.2

Release Date: 2025-12-03

Changes since: v1.0.0

Summary

  • 35 commits
  • 2 contributors

✨ Features

  • add automated GitHub release workflow (88401ba)
  • add Claude Opus 4.5 model support (017174b)

🐛 Bug Fixes

  • make lint step non-blocking in release workflow (d8b5c42)
  • improve chat scrolling with proper flexbox height constraints (0a4b4ba)

📚 Documentation

  • update CLAUDE.md with automated release workflow (31870bb)

🧹 Chores

  • bump version to 1.0.2 (fdbf2d5)
  • bump version to 1.0.1 (0330a52)
  • ([- Versi](../../commit/- Version bump script for monorepo synchronization))
  • ([- Chang](../../commit/- Changelog generator from git history))
  • ([- Compr](../../commit/- Comprehensive release and versioning documentation))
  • ([Closes ](../../commit/Closes task-2))
  • ([- Add c](../../commit/- Add comprehensive Release Workflow section))
  • ([- Docum](../../commit/- Document version bump and changelog scripts))
  • ([- Inclu](../../commit/- Include release files in Important Files section))
  • ignore (7da48f7)
  • changelog (2adac3f)
  • ([- Add o](../../commit/- Add overflow-hidden to TabsContent to prevent parent overflow conflicts))
  • ([- Wrap ](../../commit/- Wrap ScrollArea in flex container with min-h-0 for proper height constraint))
  • ([- Chang](../../commit/- Change ScrollArea from flex-1 to h-full for correct sizing))
  • ([- Add b](../../commit/- Add bg-background to input bar for visual separation))
  • ([🤖 Gene](../../commit/🤖 Generated with Claude Code))
  • ([Co-Auth](../../commit/Co-Authored-By: Claude noreply@anthropic.com))
  • gitignore (6adb406)
  • Fix chat window auto-scroll by removing CSS overflow conflict (6e9a724)
  • ([the Scr](../../commit/the ScrollArea from establishing proper scroll context. Improved scroll))
  • ([impleme](../../commit/implementation to directly access Radix UI viewport for reliable scrolling.))
  • ([🤖 Gene](../../commit/🤖 Generated with Claude Code))
  • ([Co-Auth](../../commit/Co-Authored-By: Claude noreply@anthropic.com))
  • ([- Updat](../../commit/- Update model descriptions with SWE-bench performance))
  • ([- Upgra](../../commit/- Upgrade Agent SDK from v0.1.37 to v0.1.57))
  • ([- Reord](../../commit/- Reorder models: Opus 4.5 > Sonnet 4.5 > Haiku 4.5))
  • ([- Updat](../../commit/- Update CLAUDE.md documentation with Opus 4.5 guidance))
  • ([🤖 Gene](../../commit/🤖 Generated with Claude Code))
  • ([Co-Auth](../../commit/Co-Authored-By: Claude noreply@anthropic.com))
  • Create RELEASE_NOTES_v1.0.0.md (cab28ac)

Contributors

  • bitbrujo

Installation

git clone https://github.com/yourusername/rigger.git
cd rigger
git checkout v1.0.2

Upgrading from v1.0.0

  1. Backup your database
  2. Pull latest changes: git pull && git checkout v1.0.2
  3. Rebuild containers: docker-compose down && docker-compose up -d --build
  4. Update frontend: npm install && npm run dev

Full Changelog: v1.0.0...v1.0.2

Loading

🎉 Rigger v1.0.0 - Initial Release

24 Nov 03:04
@BitBrujo BitBrujo
v1.0.0
b86bd9f

Choose a tag to compare

View all tags
🎉 Rigger v1.0.0 - Initial Release

Rigger v1.0.0 - Initial Production Release

Rigger is a comprehensive visual testing interface for the Claude Agent SDK. This initial release provides a full-featured web application for configuring AI agents, testing tools, monitoring execution, and managing agent workflows.

🚀 Feature Overview

Core Agent SDK Integration

  • 19 Built-in Tools with categorized organization:
    • 📁 File Operations: Read, Write, Edit, Glob, Grep
    • ⚙️ Execution: Bash, BashOutput, KillShell
    • 🌐 Web Access: WebFetch, WebSearch
    • 📋 Planning & Interaction: TodoWrite, Task, AskUserQuestion, ExitPlanMode
    • 🤖 Agent System: Skill, SlashCommand
  • Real-time Streaming: Server-Sent Events (SSE) for responsive UI updates
  • Debug Metrics: Comprehensive tracking of tokens, costs, cache statistics, and timing
  • Conversation Persistence: Full chat history with database storage

Session Management

  • Persistent Execution Contexts: Track agent activity across multiple requests
  • Two-Tier Emergency Stop:
    • ⏸️ Graceful Stop: Allow current operation to finish cleanly (5-second grace period)
    • 🛑 Force Kill: Immediate termination with complete resource cleanup
  • Resource Monitoring: Real-time tracking of tokens, costs, turns, and tool usage
  • Auto-Cleanup: Automatic termination of idle sessions (5-minute timeout)

Configuration Management

  • Presets System: Save and load complete agent configurations as named presets
  • Import/Export: JSON-based configuration portability for sharing
  • Change Detection: Visual indicators when active config differs from loaded preset
  • 30+ Configuration Parameters: Full control over Agent SDK settings

Advanced Capabilities

🔌 MCP (Model Context Protocol) Servers

External plugin support for extending Claude with additional tools:

  • Pre-configured templates for: GitHub, Playwright, Notion, Filesystem, Git, Memory, Time
  • Custom environment variable configuration
  • Dynamic tool discovery

📚 Skills System

  • Packaged agent workflows loaded from .claude/skills/
  • Built-in examples: PDF Processing, Data Transformation, Code Review
  • Auto-discovery and management UI
  • Create, edit, and delete skills directly from the interface

🤝 Subagents

Specialized AI agents with custom prompts and tools:

  • Built-in templates: Code Reviewer, Bug Hunter, Doc Writer, Refactorer, Test Generator
  • Independent model and temperature settings
  • Tool access restrictions for security

🪝 Hooks System

Event-driven automation with pre-built templates:

  • Triggers: on-prompt-submit, on-response-complete, on-tool-use, on-error
  • Templates: Git Auto-Commit, Slack Notifications, Error Logging, Code Formatting, Backups, API Webhooks
  • Variable interpolation for dynamic configurations

📎 File Upload System

  • Upload files up to 10MB for agent context
  • Supported formats: text, JSON, CSV, PDF, images, code files
  • Multiple integration methods: System Prompt, Working Directory, or Both
  • Global vs conversation-scoped files

🖥️ User Interface

Three-Panel Layout

The application features a responsive three-panel design:

Left Panel - Sidebar Navigation (10 tabs):

  • Sessions, Configuration, Basic Config, Tools
  • MCP Servers, Skills, Subagents, Hooks, Files, Advanced

Center Panel - Configuration Content:

  • Tab-specific configuration and management UIs
  • Real-time form validation
  • Persistent settings across sessions

Right Panel - Chat Interface (4 tabs):

  • 💬 Chat: Message history with streaming responses
  • 🐛 Debug: Token usage, costs, cache metrics, API latency
  • 🔧 Tools: Tool execution timeline with parameters and results
  • ✅ Todo: Agent-created task list visualization

🛠️ Technical Architecture

Frontend Stack

  • Framework: Next.js 16 with React 19
  • Language: TypeScript (full type safety)
  • Styling: Tailwind CSS 4 with shadcn/ui components
  • State Management: Zustand (no provider wrapping needed)
  • Real-time: Server-Sent Events (SSE)

Backend Stack

  • Framework: Express.js with Node.js
  • Language: TypeScript
  • Database: PostgreSQL with JSONB for flexible schema
  • Agent SDK: @anthropic-ai/claude-agent-sdk with full tool support
  • Containerization: Docker Compose for easy deployment

Database Schema

8 core tables with optimized indexing:

  • conversations: Chat history and messages
  • agent_sessions: Session lifecycle, metrics, emergency control
  • presets: Saved agent configurations
  • usage_logs: Per-request metrics and analytics
  • tool_usage_logs: Per-tool execution tracking
  • todos / todo_items: Task list management
  • custom_agents: User-defined subagent definitions
  • uploaded_files: File uploads for agent context

Key Design Decisions

  • Session-based execution: Persistent contexts with abort controls
  • Event-driven hooks: Automation triggers for common workflows
  • Type-safe throughout: Full TypeScript coverage for reliability
  • Docker-ready: Complete containerization with single-command startup
  • Real-time streaming: SSE for responsive UI updates without polling

📦 Installation Guide

Prerequisites

Quick Start

  1. Clone the repository:

    git clone https://github.com/BitBrujo/rigger.git
cd rigger

  2. Configure environment variables:

    Create backend/.env:

    DATABASE_URL=postgresql://agent_user:agent_pass@postgres:5432/agent_db
ANTHROPIC_API_KEY=your_api_key_here
PORT=3001

    Create .env.local:

    NEXT_PUBLIC_API_URL=http://localhost:3333/api

  3. Start backend and database:

    docker-compose up -d

    Wait ~10 seconds for PostgreSQL initialization.

  4. Install frontend dependencies:

    npm install

  5. Start development server:

    npm run dev

  6. Access the application:

    Open http://localhost:3334 in your browser.

Port Configuration

  • Frontend: 3334 (Next.js)
  • Backend API: 3333 (Express - external)
  • Database: 5335 (PostgreSQL - external)

Verification

Test the backend health endpoint:

curl http://localhost:3333/health

📚 Documentation

  • README.md: Project overview and quick start guide
  • CHANGELOG.md: Complete feature documentation and version history
  • CLAUDE.md: Comprehensive architecture and developer documentation (1000+ lines)
    • Complete application structure
    • Request flow diagrams
    • Database schema details
    • Development patterns
    • Troubleshooting guide
  • Skills Documentation: .claude/skills/README.md

🎯 Use Cases

Development & Testing:

  • Test Claude Agent SDK integrations before production deployment
  • Experiment with different tool combinations and configurations
  • Debug agent behavior with comprehensive metrics

Workflow Automation:

  • Create custom skills for repetitive tasks
  • Set up hooks for event-driven automation
  • Integrate external tools via MCP servers

Team Collaboration:

  • Share agent configurations via presets
  • Export/import JSON configurations across projects
  • Manage conversation history for review

Learning & Experimentation:

  • Explore Claude's capabilities with 19 built-in tools
  • Understand token usage and costs with real-time metrics
  • Test subagents with specialized prompts

📸 Screenshots

The application features a modern, responsive interface with:

  • Dark mode support with next-themes
  • Resizable panels for customized layouts
  • Real-time streaming with visual indicators
  • Comprehensive debug panels showing all API metrics
  • Tool execution timeline with parameters and results
  • Session controls with emergency stop buttons

(Screenshots can be added to the repository wiki or documentation site)

🔮 Future Plans

  • Enhanced analytics dashboard with charts and visualizations
  • Team collaboration features (shared sessions, comments)
  • Custom theme support beyond dark/light modes
  • Plugin marketplace for MCP servers and skills
  • API documentation generator from tool usage
  • Performance profiling tools for optimization
  • Export conversations to various formats (PDF, Markdown, JSON)

🤝 Contributing

Contributions are welcome! Please see the repository for contribution guidelines.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgments

Built with:

Thank you for trying Rigger v1.0.0! 🎉

For issues, questions, or feature requests, please visit the GitHub Issues page.

Loading