Releases: gitcoder89431/agentic
Agentic-v0.1.4
⏺ Release Notes - Agentic v0.1.4
🔧 Enhanced Error Handling & Debugging
This release significantly improves reliability and troubleshooting capabilities for both local and cloud
model interactions.
🚀 New Features
Robust JSON Parsing with Multiple Fallback Strategies
- Added 4-tier fallback system for parsing local model responses
- Enhanced cloud synthesis parsing with multiple extraction methods
- Automatic recovery from malformed JSON responses
- Text pattern matching as final fallback for proposal extraction
Comprehensive Debug Logging
- 10+ new debug files written to /tmp/ for detailed troubleshooting
- Local model debugging: debug_prompt.txt, debug_response.txt, debug_error.txt
- Cloud synthesis debugging: debug_synthesis_prompt.txt, debug_cloud_response.txt, debug_synthesis_json.txt
- Parse error diagnostics: debug_parse_error.txt, debug_parse_failure.txt
Enhanced Endpoint Validation
- Settings validation now tests actual generation capabilities (not just model listing)
- Validates both /api/generate (Ollama) and /v1/chat/completions (LM Studio/OpenAI) endpoints
- Prevents configuration issues where models are visible but generation fails
Provider Detection Caching
- Global caching system ensures consistent provider detection throughout session
- Eliminates potential validation/generation mismatches
- Reduces redundant API calls for better performance
🐛 Bug Fixes
Fixed LM Studio → Cloud Synthesis Issues
- Resolved parsing errors when switching from Ollama to LM Studio
- Enhanced cloud model response handling with better error context
- Improved JSON extraction from various response formats
Improved Error Messages
- More descriptive error messages with endpoint and model context
- Better user guidance for troubleshooting connection issues
- Enhanced coaching tips with specific next steps
🏗️ Technical Improvements
Code Quality
- All code formatted with rustfmt
- Zero clippy warnings
- Enhanced error propagation following Rust best practices
- Proper separation of concerns following RuixenOS workspace architecture
Following Constitutional Patterns
- No .unwrap() or .expect() in application logic
- Graceful error handling with comprehensive fallbacks
- Non-blocking operations maintained
- Consistent with established architectural principles
📋 What's Changed
- Enhanced local model error handling and debugging
- Added generation endpoint validation to settings
- Implemented JSON parsing with 4-tier fallback strategies
- Added consistent provider detection caching
- Updated all version references from 0.1.3 to 0.1.4
This release makes Agentic significantly more robust when dealing with network hiccups, different local model response formats, and provider switching scenarios. The extensive debug logging will help users and developers quickly identify and resolve any remaining edge cases.
Agentic v0.1.3
v0.1.3 Release Features:
- 🆕 LM Studio Integration - Auto-detects and supports OpenAI-compatible APIs
- 🔄 Multi-Provider Architecture - Seamless switching between Ollama/LM Studio/OpenAI
- 🐛 JSON Parsing Fixes - Handles markdown-wrapped responses from all providers
- 🎯 Smart Defaults - Ollama (localhost:11434) for beginners, flexible for power users
- ✨ Clean UI - No debug spam, production-ready interface
Agentic v0.1.2
🆕 Obsidian Integration Feature Added
This feature release adds native Obsidian compatibility to Ruixen's atomic notes system! Your saved insights now seamlessly integrate with the world's most popular knowledge management tool.
✨ New Features
- 🔗 Native Obsidian Support: Atomic notes now use Obsidian-native YAML tag format
- 📊 Graph View Integration: Tags automatically appear in Obsidian's knowledge graph
- 🏷️ Tag Navigation: Click tags to explore related notes and build connections
- 🌐 Knowledge Network: Watch your insights form natural clusters and relationships
🚀 Installation
Install the latest version:
cargo install ruixenOr download platform-specific binaries from the release assets below.
🎯 How It Works
- Ruixen generates tags in pure YAML array format:
[astronomy, science, curiosity] - Drop your
~/Documents/ruixen/folder into any Obsidian vault - Tags instantly become clickable, searchable, and graph-connected
- Build a living knowledge network from your AI conversations
🧠 Knowledge Management Revolution
Transform your Ruixen conversations into:
- Connected Insights: See how topics naturally relate in graph view
- Searchable Wisdom: Find past explorations through tag navigation
- Evolving Understanding: Watch your curiosity patterns emerge over time
- Research Foundation: Build upon previous insights and discoveries
🦀 Built with Rust | 🤖 AI-Collaborative Development
Ruixen v0.1.1
🐛 Critical Hotfix: Terminal.app Color Compatibility
This patch release fixes a critical issue where Ruixen displayed incorrectly in pink/magenta colors on macOS Terminal.app, while working perfectly in iTerm2 and other modern terminals.
🔧 What's Fixed
- Terminal Detection: Added smart terminal detection using
$TERM_PROGRAMenvironment variable - Color Fallback: Terminal.app now uses indexed colors instead of RGB colors for perfect compatibility
- Preserved Quality: iTerm2, VS Code terminal, and other modern terminals still get beautiful Everforest RGB colors
🚀 Installation
Install the latest version:
cargo install ruixenOr download platform-specific binaries from the release assets below.
💡 Technical Details
- Detects Terminal.app via
TERM_PROGRAM=Apple_Terminal - Provides indexed color fallback (Color::Green, Color::White, etc.)
- Maintains full RGB color support for modern terminals
- No performance impact or feature degradation
🎯 First Impressions Matter
This ensures Ruixen works beautifully across all macOS terminal environments, providing the best possible first experience for new users.
🦀 Built with Rust | 🤖 AI-Collaborative Development
Ruixen v0.1.0 - The Curiosity Machine
🎯 Ruixen v0.1.0 - The Curiosity Machine
The collaborative AI agent you work WITH.
Transform simple questions into profound insights through thoughtful query refinement and synthesis.
Ruixen doesn't just answer - it awakens wonder.
✨ What's New
- 🤝 Collaborative Experience: Work WITH an AI agent, not command it - experience true intellectual
partnership - 🧠 Hybrid AI Architecture: Local model for private query orchestration + powerful cloud models for
synthesis - 🌸 Beautiful Zen Garden TUI: Minimalist keyboard-driven interface with Everforest theming
- 📝 Atomic Note System: Automatically saves insights as structured Markdown + YAML to ~/Documents/ruixen/
- 🦀 Constitutional Rust: Zero panics, graceful error handling, and modern async patterns
- 🔍 Query Refinement Engine: Transforms basic questions into thoughtful, multi-faceted explorations
- ⚡ Fast & Lightweight: 5MB native binary with no dependencies
🚀 Installation
Via Cargo (Recommended)
cargo install ruixen
ruixen
Direct Download
Download the ruixen binary below, make it executable, and add to your PATH:
chmod +x ruixen
sudo mv ruixen /usr/local/bin/
⚙️ Quick Setup
Ruixen requires both local and cloud AI to create the collaborative experience:
- Local AI (Required)
Install Ollama
brew install ollama # or visit ollama.ai
Pull a model
ollama pull llama3.2:3b
- Cloud AI (Required)
- Get a free API key from https://openrouter.ai
- Many free models available (no credit card needed for testing)
- First Launch
ruixen
Press 's' → Enter your OpenRouter API key → Select models → Start exploring!
🌟 Try Your First Query
Ask something that sparks genuine curiosity:
"Where do the stars go during the day?"
Watch Ruixen transform childhood wonder into scientific understanding while preserving the magic of
discovery.
🎨 Features
- Thoughtful Query Orchestration: Local AI refines your questions into profound explorations
- Seamless Cloud Synthesis: Powerful models create insightful, educational responses
- Knowledge Base Building: Every interaction becomes a searchable atomic note
- Privacy-First Design: Sensitive orchestration happens locally, only refined queries go to cloud
- Responsive Design: Works beautifully on any terminal size
- Rich Theming: Dark/light mode with carefully chosen color palettes
📖 Philosophy
"The curiosity machine doesn't just process queries - it awakens wonder."
Ruixen embodies a new paradigm for human-AI collaboration. Instead of the typical command-response
dynamic, it creates a thinking partnership where both human curiosity and AI capability combine to explore
ideas together.
🛠️ Built With
- Rust - For performance, safety, and reliability
- Ratatui - Beautiful terminal user interfaces
- Tokio - Async runtime for responsive interactions
- Constitutional Patterns - Every error handled gracefully
📚 Documentation
- Full Setup Guide: https://github.com/gitcoder89431/agentic#configuration
- Model Selection Guide: Learn how to choose the right AI models
- Troubleshooting: Common issues and solutions
🤝 Contributing
Built with love using constitutional Rust patterns. Issues and PRs welcome!