# Hiroshi

## Docs

- [Schedule Recurring Agent Tasks with Cron Schedules](https://docs.hiroshios.xyz/automation/cron.md): Define scheduled tasks in config.toml to have Hiroshi automatically run agent prompts on a cron schedule — daily reports, workspace triage, and more.
- [Automate Proactive Agent Routines with the SOP Engine](https://docs.hiroshios.xyz/automation/sop.md): Configure Hiroshi's SOP engine to run autonomous agent routines on a fixed interval and push results to Telegram, Discord, or Slack.
- [Define, Manage, and Switch Agent Roles in AGENTS.md](https://docs.hiroshios.xyz/configuration/agents.md): Learn how to define custom agent roles, system prompts, allowed tools, and automatic handoff rules in your ~/.hiroshi/AGENTS.md file.
- [Hiroshi config.toml — Complete Configuration Reference](https://docs.hiroshios.xyz/configuration/config-file.md): Complete reference for ~/.hiroshi/config.toml — Ollama model settings, security sandbox, cron tasks, SOP routines, and channel gateway tokens.
- [Personalizing Hiroshi's Behavior with SOUL.md and USER.md](https://docs.hiroshios.xyz/configuration/soul-and-user.md): Personalize Hiroshi's identity, tone, and behavior with SOUL.md, and give it your personal context with USER.md to improve every response.
- [Hiroshi Web Dashboard — Visual Agent Workspace UI](https://docs.hiroshios.xyz/dashboard/overview.md): The Hiroshi web dashboard streams real-time agent activity, shows system metrics, and lets you enable or disable skills from a browser UI at port 8080.
- [Install Hiroshi on Linux, macOS, or Windows from Source](https://docs.hiroshios.xyz/installation.md): Step-by-step guide to building and installing Hiroshi from source using Cargo, covering Ollama setup, feature flags, and first-run configuration.
- [Set Up a Discord Bot Gateway for Your Hiroshi Agent](https://docs.hiroshios.xyz/integrations/discord.md): Set up a Discord bot gateway to chat with Hiroshi in Discord channels — configure your bot token and specify which channel IDs to allow.
- [Add External MCP Tool Servers to Your Hiroshi Agent](https://docs.hiroshios.xyz/integrations/mcp.md): Connect external Model Context Protocol servers to Hiroshi to give the agent access to databases, APIs, and custom tools via JSON-RPC 2.0.
- [Configure Slack Socket Mode to Chat With Your Hiroshi Agent](https://docs.hiroshios.xyz/integrations/slack.md): Set up a Slack app gateway to interact with Hiroshi from Slack using Socket Mode — configure your bot token and app-level token in config.toml.
- [Access the Hiroshi Dashboard Remotely via Tailscale](https://docs.hiroshios.xyz/integrations/tailscale.md): Use Tailscale to expose the Hiroshi web dashboard over your private Tailnet, enabling secure remote access from any device on your network.
- [Configure Telegram Bot Access for Your Hiroshi Agent](https://docs.hiroshios.xyz/integrations/telegram.md): Set up a Telegram bot gateway so you can chat with Hiroshi from Telegram — configure your bot token and authorize user IDs in config.toml.
- [Introduction to Hiroshi: Agents, Skills, and Memory](https://docs.hiroshios.xyz/introduction.md): Learn what Hiroshi is, how its multi-agent loop works, and what you can build with custom skills, MCP servers, and chat integrations.
- [How Hiroshi Remembers: Persistent Semantic Memory System](https://docs.hiroshios.xyz/memory/overview.md): Hiroshi stores conversation history in SQLite with hybrid vector and FTS5 full-text search, enabling fast semantic recall across sessions in under 15ms.
- [Get Started with Hiroshi: Install, Configure, and Chat](https://docs.hiroshios.xyz/quickstart.md): Launch your first Hiroshi agent session, send messages, switch agents, and explore skills — from install to first response in minutes.
- [Hiroshi Built-In Skills: Five-Tool Reference Guide](https://docs.hiroshios.xyz/skills/built-in.md): Hiroshi ships with five built-in skills: git_manager, web_search, browser_automation, file_janitor, and task_sync — auto-generated on first run.
- [Custom Hiroshi Skills: Write, Register, and Run Scripts](https://docs.hiroshios.xyz/skills/custom.md): Build custom skills for Hiroshi using any scripting language — define a SKILL.md manifest and an executable script to add new agent capabilities.
- [Hiroshi Skills Overview: Extend the Agent with Scripts](https://docs.hiroshios.xyz/skills/overview.md): Skills are polyglot script extensions that Hiroshi discovers automatically and calls as tools — add Python, Bash, or any script to extend the agent.