botiasloop 0.0.1 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b2c58deeefe3094bad216a8dd08b0fa9df9ea5e79924a088f77723d88542a64
-  data.tar.gz: 0d7bc8c46234f75313694d9c6adc1c35642ef012bf8cce15202d63bdadf52c93
+  metadata.gz: 19ce350bd375ddbae065af8ff880cfe1f4f01c1d53b0b865caec2d577119c7bc
+  data.tar.gz: 41021e8b39ce89d96b04000d2c9d6e23f78672915561d5c17ee81846faf87ed3
 SHA512:
-  metadata.gz: 6f17a7416ca693846a9070b998a59355de00dd9bbf707461bf28d6ab6469dfb0e6544619f6097a809b86f11acec6e2de33371f1ec60499484ca0c7aaa09fb03c
-  data.tar.gz: ff0d76df0c00904b848581c840fa1bae29c8f707a23e38da07698894e488482194c9368760a2c78fced02d0604f750cd3b1f1cae8e29256c240d4d8fbcf4ec7d
+  metadata.gz: d017fa894d1c47e03ef694b3f25a4144e84b5dc0a8b645add7e871062bf7cb754a65febf450ab5964c273196bebbbda7481a1da5f738fd125058b909ddb0b213
+  data.tar.gz: c848deadc5eb12e6aa07ffb539bd11a6cb3c2559a88a24285cb7768694c5818f7c9e6b21bffea5dbd6bffe862cfd3a800f130ef0543d6afa65fe77140be41d4f

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2026 Tobias Feistmantl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,62 +1,25 @@
-# BotiasLoop
-
-A minimal agentic AI application built on the ReAct (Reasoning + Acting) loop pattern. BotiasLoop provides an AI agent with shell access and web search capabilities via OpenRouter, designed for dedicated infrastructure following the Rails Doctrine.
+# 🤖 BotiasLoop
 
 [![Ruby](https://img.shields.io/badge/ruby-3.4%2B-red.svg)](https://www.ruby-lang.org/)
+[![Gem Version](https://img.shields.io/gem/v/botiasloop.svg)](https://rubygems.org/gems/botiasloop)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![StandardRB](https://img.shields.io/badge/code_style-standard-success.svg)](https://github.com/standardrb/standard)
+[![Tests](https://img.shields.io/badge/tests-rspec-brightgreen.svg)]()
 
-## Philosophy
-
-**Sharp Knives**: BotiasLoop intentionally provides full shell access without restrictions. This is a feature, not a bug. It's designed for dedicated infrastructure where raw power is needed, not personal devices. The agent can execute any shell command, read any file, and make system changes.
-
-Following the Rails Doctrine:
-- **Optimize for programmer happiness**: Beautiful, readable Ruby code
-- **Convention over Configuration**: Sensible defaults, minimal setup required
-- **The menu is omakase**: Curated stack (ruby_llm, StandardRB, RSpec)
-- **No one paradigm**: Practical over pure - use what works
-
-## Features
-
-### Core
-- **ReAct Loop**: AI reasons, acts using tools, observes results, and repeats
-- **Shell Access**: Execute any shell command (full system access)
-- **Web Search**: Search the web via SearXNG
-- **Conversation Persistence**: SQLite-backed conversation storage with UUID tracking
-- **Token Tracking**: Monitor input/output tokens per conversation
-
-### Channels
-- **CLI Mode**: Interactive REPL for local usage
-- **Telegram Bot**: Chat with the agent via Telegram
-- **Multi-Channel**: Run multiple channels simultaneously
-- **Boot Auto-Start**: systemd service with automatic startup on boot
-
-### Commands
-Slash commands for conversation management:
-- `/new` - Start a new conversation
-- `/switch <label|uuid>` - Switch to a different conversation
-- `/label <name>` - Label the current conversation
-- `/conversations` - List all conversations
-- `/reset` - Clear current conversation history
-- `/compact` - Summarize and archive old messages
-- `/status` - Show current model, token usage
-- `/archive` - Archive old conversations
-- `/system_prompt` - Show current system prompt
-- `/help` - Show available commands
-
-### Skills System
-Skills follow the [agentskills.io](https://agentskills.io) specification:
-- Load default skills from `data/skills/`
-- Load custom skills from `~/skills/`
-- Progressive disclosure: name/description in system prompt, full content on demand
-- Includes `skill-creator` skill for creating new skills
+> **Think. Act. Repeat.**
+>
+> A minimal agentic AI application built on the ReAct (Reasoning + Acting) loop pattern.
 
-## Installation
+BotiasLoop gives your AI agent **full shell access** and **web search capabilities** via multiple LLM providers. Designed for dedicated infrastructure following the Rails Doctrine — beautiful code, sensible defaults, sharp knives.
+
+---
+
+## 🚀 Installation
 
 ### Prerequisites
 
 - Ruby 3.4 or higher
-- OpenRouter API key
+- API key from your preferred LLM provider (see supported providers below)
 - (Optional) SearXNG instance for web search
 
 ### Via RubyGems
@@ -87,38 +50,115 @@ mise install
 mise exec ruby -- bundle install
 ```
 
-## Configuration
+---
 
-Create `~/.config/botiasloop/config.yml`:
+## ⚡ Quick Start
 
-```yaml
-# Required: OpenRouter configuration
-providers:
-  openrouter:
-    api_key: "your-openrouter-api-key"  # Or set BOTIASLOOP_API_KEY env var
-    model: "moonshotai/kimi-k2.5"       # Any OpenRouter model
+```bash
+# 1. Configure your API key
+export BOTIASLOOP_API_KEY="your-api-key"
 
-# Optional: Web search configuration
-tools:
-  web_search:
-    searxng_url: "http://localhost:8080"  # Your SearXNG instance
+# 2. Start chatting
+botiasloop cli
 
-# Optional: Maximum ReAct iterations (default: 20)
-max_iterations: 20
+# 3. Ask anything!
+You: What's the weather in Tokyo?
 
-# Optional: Telegram channel
-channels:
-  telegram:
-    bot_token: "your-telegram-bot-token"
-    allowed_users: []  # Empty = allow all, or list specific user IDs
+Agent: I'll search for the current weather in Tokyo for you.
+
+[Tool] Executing web_search with arguments: {"query"=>"current weather Tokyo Japan"}
+
+The weather in Tokyo is currently...
 ```
 
-### Environment Variables
+---
+
+## ✨ Features
+
+### 🧠 Core Capabilities
+
+- **ReAct Loop** — AI reasons, acts using tools, observes results, and repeats
+- **12+ LLM Providers** — OpenRouter, OpenAI, Anthropic, Gemini, DeepSeek, Mistral, Perplexity, Ollama, and more
+- **Shell Access** — Execute any shell command (full system access)
+- **Web Search** — Search the web via SearXNG integration
+- **Token Tracking** — Monitor input/output tokens per conversation
+
+### 💬 Channels & Interfaces
+
+- **CLI Mode** — Interactive REPL for local usage
+- **Telegram Bot** — Chat with your agent anywhere
+- **Multi-Channel** — Run CLI + Telegram simultaneously
+- **One-Shot Mode** — Single command execution
+
+### 🗄️ Conversation Management
+
+- **Persistent Storage** — JSONL-backed conversation history
+- **UUID Tracking** — Every conversation has a unique ID
+- **Auto-Labeling** — Conversations get human-readable names
+- **Conversation Switching** — Jump between active chats
+- **Archiving** — Keep your workspace clean
+
+### 🛠️ Built-in Tools
+
+| Tool | Description |
+|------|-------------|
+| 🔧 `shell` | Execute any shell command |
+| 🔍 `web_search` | Search the web via SearXNG |
+
+### 📚 Skills System
+
+Skills follow the [agentskills.io](https://agentskills.io) specification:
+
+- Load default skills from `data/skills/`
+- Load custom skills from `~/skills/`
+- Progressive disclosure: name/description in system prompt, full content on demand
+- Includes `skill-creator` skill for creating new skills
+
+### ⌨️ Slash Commands
+
+Manage conversations with intuitive commands:
+
+| Command | Description |
+|---------|-------------|
+| `/new` | Start a new conversation |
+| `/switch <label\|uuid>` | Switch to a different conversation |
+| `/label <name>` | Label the current conversation |
+| `/conversations` | List all conversations |
+| `/reset` | Clear current conversation history |
+| `/compact` | Summarize and archive old messages |
+| `/status` | Show current model, token usage |
+| `/archive` | Archive old conversations |
+| `/system_prompt` | Show current system prompt |
+| `/verbose` | Toggle verbose mode (show tool calls) |
+| `/help` | Show available commands |
+
+---
+
+## 🎨 Philosophy
+
+### Sharp Knives 🔪
+
+BotiasLoop intentionally provides **full shell access without restrictions**. This is a feature, not a bug. It's designed for dedicated infrastructure where raw power is needed, not personal devices.
 
-- `BOTIASLOOP_API_KEY` - OpenRouter API key (overrides config file)
-- `BOTIASLOOP_SEARXNG_URL` - SearXNG URL (overrides config file)
+The agent can:
+- Execute any shell command
+- Read, write, and delete any file
+- Install software
+- Modify system configuration
+- Access network resources
+
+### Rails Doctrine 🚂
 
-## Usage
+Following the [Rails Doctrine](https://rubyonrails.org/doctrine):
+
+- **Optimize for programmer happiness** — Beautiful, readable Ruby code
+- **Convention over Configuration** — Sensible defaults, minimal setup required
+- **The menu is omakase** — Curated stack (ruby_llm, StandardRB, RSpec)
+- **No one paradigm** — Practical over pure - use what works
+
+---
+
+## 📖 Usage
 
 ### CLI Mode
 
@@ -130,6 +170,14 @@ botiasloop cli
 
 Exit with: `exit`, `quit`, `\q`, or Ctrl+C
 
+### One-Shot Mode
+
+Send a single message:
+
+```bash
+botiasloop "What's the weather in Tokyo?"
+```
+
 ### Gateway Mode (Telegram Bot)
 
 Start the gateway to enable Telegram and other channels:
@@ -143,17 +191,10 @@ botiasloop gateway enable   # Install and enable boot auto-start
 botiasloop gateway start    # Start the service now
 botiasloop gateway status   # Check service status
 botiasloop gateway stop     # Stop the service
+botiasloop gateway logs     # View service logs
 botiasloop gateway disable  # Disable boot auto-start and uninstall
 ```
 
-### One-Shot Mode
-
-Send a single message:
-
-```bash
-botiasloop "What's the weather in Tokyo?"
-```
-
 ### Example Session
 
 ```bash
@@ -182,12 +223,120 @@ You: /label my-project
 
 Agent: **Conversation labeled as `my-project`**
 
+You: /verbose
+
+Agent: **Verbose mode enabled** — You will now see reasoning and tool execution details.
+
 You: exit
 
 Goodbye!
 ```
 
-## Development
+---
+
+## ⚙️ Configuration
+
+Create `~/.config/botiasloop/config.yml`:
+
+### OpenRouter (Recommended)
+
+```yaml
+providers:
+  openrouter:
+    api_key: "your-openrouter-api-key"
+    model: "moonshotai/kimi-k2.5"
+```
+
+### OpenAI
+
+```yaml
+providers:
+  openai:
+    api_key: "your-openai-api-key"
+    model: "gpt-4o"
+```
+
+### Anthropic
+
+```yaml
+providers:
+  anthropic:
+    api_key: "your-anthropic-api-key"
+    model: "claude-3-5-sonnet-20241022"
+```
+
+### Ollama (Local)
+
+```yaml
+providers:
+  ollama:
+    api_base: "http://localhost:11434/v1"
+    model: "llama3.2"
+```
+
+### Full Configuration Example
+
+```yaml
+# Required: Provider configuration
+providers:
+  openrouter:
+    api_key: "your-api-key"
+    model: "moonshotai/kimi-k2.5"
+
+# Optional: Web search configuration
+tools:
+  web_search:
+    searxng_url: "http://localhost:8080"
+
+# Optional: Maximum ReAct iterations (default: 20)
+max_iterations: 20
+
+# Optional: Telegram channel
+channels:
+  telegram:
+    bot_token: "your-telegram-bot-token"
+    allowed_users: []  # Empty = allow all, or list specific user IDs
+
+# Optional: Logging
+logger:
+  level: "info"  # debug, info, warn, error
+  destination: "stdout"  # stdout, stderr, or path to log file
+```
+
+### Environment Variables
+
+Environment variables override config file values:
+
+| Variable | Description |
+|----------|-------------|
+| `BOTIASLOOP_API_KEY` | API key for the active provider |
+| `BOTIASLOOP_SEARXNG_URL` | SearXNG URL for web search |
+| `BOTIASLOOP_LOG_LEVEL` | Log level (debug, info, warn, error) |
+
+---
+
+## 🔒 Security
+
+⚠️ **IMPORTANT**: BotiasLoop provides **full shell access**. The AI agent can:
+- Execute any shell command
+- Read, write, and delete any file
+- Install software
+- Modify system configuration
+- Access network resources
+
+**Use only on dedicated infrastructure**, never on personal devices or production systems containing sensitive data.
+
+### Future Security Features (Roadmap)
+
+- Sandboxed execution (Docker/Firejail)
+- Command whitelist/blacklist
+- Confirmation for destructive operations
+- Read-only mode option
+- Secret management integration
+
+---
+
+## 🛠️ Development
 
 ### Setup
 
@@ -237,7 +386,9 @@ bundle exec standardrb --fix
 bundle exec rake
 ```
 
-## Architecture
+---
+
+## 📁 Architecture
 
 ```
 botiasloop/
@@ -249,7 +400,9 @@ botiasloop/
 │       ├── agent.rb            # Main orchestrator
 │       ├── loop.rb             # ReAct cycle implementation
 │       ├── config.rb           # Configuration management
-│       ├── conversation.rb     # Conversation persistence (SQLite)
+│       ├── conversation.rb     # Conversation persistence
+│       ├── conversation_manager.rb  # Multi-conversation management
+│       ├── auto_label.rb       # Auto-labeling conversations
 │       ├── tool.rb             # Base tool class
 │       ├── tools/
 │       │   ├── registry.rb     # Tool registration
@@ -267,45 +420,32 @@ botiasloop/
 │       │   ├── base.rb         # Channel base class
 │       │   ├── cli.rb          # CLI channel
 │       │   └── telegram.rb     # Telegram bot
-│       └── channels_manager.rb # Multi-channel orchestration
+│       ├── channels_manager.rb # Multi-channel orchestration
+│       └── systemd_service.rb  # Service management
 ├── data/
 │   └── skills/                 # Default skills
 ├── spec/                       # Test suite
 └── README.md                   # This file
 ```
 
-## Security
-
-⚠️ **IMPORTANT**: BotiasLoop provides full shell access. The AI agent can:
-- Execute any shell command
-- Read, write, and delete any file
-- Install software
-- Modify system configuration
-- Access network resources
-
-**Use only on dedicated infrastructure**, never on personal devices or production systems containing sensitive data.
+---
 
-### Future Security Features (Roadmap)
-- Sandboxed execution (Docker/Firejail)
-- Command whitelist/blacklist
-- Confirmation for destructive operations
-- Read-only mode option
-- Secret management integration
+## 🗺️ Roadmap
 
-## Roadmap
+See [ROADMAP.md](ROADMAP.md) for detailed planned features:
 
-See [ROADMAP.md](ROADMAP.md) for detailed planned features including:
+- **Persistent Memory** — Vector database for semantic search
+- **Custom Tools** — Load tools from `~/tools/`
+- **Conversation Compaction** — Automatic summarization
+- **Subagents** — Specialized agent instances
+- **Streaming Responses** — Real-time token display
+- **Multi-Modal** — Image analysis, audio transcription
+- **Web Dashboard** — Browser-based management UI
+- **Plugin System** — Load plugins from gems
 
-- **Persistent Memory**: Vector database for semantic search
-- **Custom Tools**: Load tools from `~/tools/`
-- **Conversation Compaction**: Automatic summarization
-- **Subagents**: Specialized agent instances
-- **Streaming Responses**: Real-time token display
-- **Multi-Modal**: Image analysis, audio transcription
-- **Web Dashboard**: Browser-based management UI
-- **Plugin System**: Load plugins from gems
+---
 
-## Contributing
+## 🤝 Contributing
 
 1. Fork the repository
 2. Create a feature branch
@@ -319,24 +459,28 @@ See [ROADMAP.md](ROADMAP.md) for detailed planned features including:
 
 ### Development Principles
 
-- **Test-First**: All features built using TDD
-- **Sharp Knives**: Keep raw power, minimal restrictions
-- **Rails Doctrine**: Optimize for programmer happiness
-- **Privacy First**: Local-first, user-controlled data
-- **Unix Philosophy**: Do one thing well, compose with other tools
+- **Test-First** — All features built using TDD
+- **Sharp Knives** — Keep raw power, minimal restrictions
+- **Rails Doctrine** — Optimize for programmer happiness
+- **Privacy First** — Local-first, user-controlled data
+- **Unix Philosophy** — Do one thing well, compose with other tools
+
+---
 
-## License
+## 📜 License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+MIT License — see [LICENSE](LICENSE) file for details.
+
+---
 
-## Credits
+## 🙏 Credits
 
 Built by [Tobias Feistmantl](https://github.com/0x7466) with inspiration from nanobot and the Ruby on Rails doctrine.
 
 Powered by:
-- [ruby_llm](https://github.com/crmne/ruby_llm) - Unified LLM API
-- [OpenRouter](https://openrouter.ai/) - Unified LLM API gateway
-- [SearXNG](https://docs.searxng.org/) - Privacy-respecting metasearch
+- [ruby_llm](https://github.com/crmne/ruby_llm) — Unified LLM API
+- [OpenRouter](https://openrouter.ai/) — Unified LLM API gateway
+- [SearXNG](https://docs.searxng.org/) — Privacy-respecting metasearch
 
 ---
 

data/bin/botiasloop

@@ -3,6 +3,9 @@
 
 require_relative "../lib/botiasloop"
 
+# Initialize global config instance
+Botiasloop::Config.instance = Botiasloop::Config.new
+
 def print_help
   puts "botiasloop - Minimal agentic AI with ReAct loop"
   puts
@@ -22,11 +25,16 @@ def print_help
   puts "  stop             Stop the systemd service"
   puts "  restart          Restart the systemd service"
   puts "  status           Show systemd service status"
+  puts "  logs             Show service logs (journalctl)"
   puts "  enable           Install and enable systemd service (auto-start on login)"
   puts "  disable          Disable and uninstall systemd service"
+  puts
+  puts "Logs Options:"
+  puts "  -f, --follow     Follow log output in real-time"
+  puts "  -n, --lines N    Show last N lines (default: 50)"
 end
 
-def start_gateway(config)
+def start_gateway
   # Check if any channels are configured (excluding CLI)
   available_channels = Botiasloop::Channels.registry.channels.except(:cli)
 
@@ -36,10 +44,10 @@ def start_gateway(config)
     exit 1
   end
 
-  manager = Botiasloop::ChannelsManager.new(config)
+  manager = Botiasloop::ChannelsManager.new
 
   # Start all channels and wait
-  manager.start_channels.wait
+  manager.start_listening.wait
 end
 
 if ARGV[0] == "-h" || ARGV[0] == "--help"
@@ -47,10 +55,8 @@ if ARGV[0] == "-h" || ARGV[0] == "--help"
 elsif ARGV[0] == "-v" || ARGV[0] == "--version"
   puts "botiasloop #{Botiasloop::VERSION}"
 elsif ARGV[0] == "gateway"
-  config = Botiasloop::Config.new
-
   if ARGV[1] == "start"
-    service = Botiasloop::SystemdService.new(config)
+    service = Botiasloop::SystemdService.new
     if service.systemd_available?
       begin
         service.start
@@ -64,7 +70,7 @@ elsif ARGV[0] == "gateway"
       exit 1
     end
   elsif ARGV[1] == "stop"
-    service = Botiasloop::SystemdService.new(config)
+    service = Botiasloop::SystemdService.new
     if service.systemd_available?
       begin
         service.stop
@@ -78,7 +84,7 @@ elsif ARGV[0] == "gateway"
       exit 1
     end
   elsif ARGV[1] == "restart"
-    service = Botiasloop::SystemdService.new(config)
+    service = Botiasloop::SystemdService.new
     if service.systemd_available?
       begin
         service.restart
@@ -92,7 +98,7 @@ elsif ARGV[0] == "gateway"
       exit 1
     end
   elsif ARGV[1] == "status"
-    service = Botiasloop::SystemdService.new(config)
+    service = Botiasloop::SystemdService.new
     if service.systemd_available?
       status = service.status
       puts "Service status: #{status[:message]}"
@@ -101,8 +107,53 @@ elsif ARGV[0] == "gateway"
       puts "Error: systemd is not available on this system"
       exit 1
     end
+  elsif ARGV[1] == "logs"
+    service = Botiasloop::SystemdService.new
+    if service.systemd_available?
+      # Parse logs options
+      follow = false
+      lines = 50
+
+      # Parse arguments from ARGV[2..] to support both -n 100 and --lines 100 formats
+      i = 2
+      while i < ARGV.length
+        arg = ARGV[i]
+
+        if arg == "-f" || arg == "--follow"
+          follow = true
+          i += 1
+        elsif arg == "-n" || arg == "--lines"
+          if i + 1 >= ARGV.length
+            puts "Error: #{arg} requires a value"
+            exit 1
+          end
+
+          lines_str = ARGV[i + 1]
+          unless lines_str.match(/^\d+$/)
+            puts "Error: Invalid number of lines: #{lines_str}"
+            exit 1
+          end
+
+          lines = lines_str.to_i
+          i += 2
+        else
+          puts "Unknown option: #{arg}"
+          exit 1
+        end
+      end
+
+      begin
+        service.logs(follow: follow, lines: lines)
+      rescue Botiasloop::SystemdError => e
+        puts "Error: #{e.message}"
+        exit 1
+      end
+    else
+      puts "Error: systemd is not available on this system"
+      exit 1
+    end
   elsif ARGV[1] == "enable"
-    service = Botiasloop::SystemdService.new(config)
+    service = Botiasloop::SystemdService.new
     if service.systemd_available?
       begin
         service.install unless service.installed?
@@ -118,7 +169,7 @@ elsif ARGV[0] == "gateway"
       exit 1
     end
   elsif ARGV[1] == "disable"
-    service = Botiasloop::SystemdService.new(config)
+    service = Botiasloop::SystemdService.new
     if service.systemd_available?
       begin
         if service.installed?
@@ -136,13 +187,12 @@ elsif ARGV[0] == "gateway"
       exit 1
     end
   else
-    start_gateway(config)
+    start_gateway
   end
 elsif ARGV[0] == "cli"
   # CLI interactive mode
-  config = Botiasloop::Config.new
-  cli_channel = Botiasloop::Channels::CLI.new(config)
-  cli_channel.start
+  cli_channel = Botiasloop::Channels::CLI.new
+  cli_channel.start_listening
 elsif ARGV.empty? || ARGV[0] == "help"
   # Default to help when no args or explicit help command
   print_help