Ryvos

Ryvos ships with 86+ built-in tools across 18 categories. The agent selects tools automatically based on your request — you do not need to invoke them directly. Every tool implements the Tool trait with a name, description, JSON Schema input, security tier, and timeout.

Tool Categories

Core Tools (12)

The foundational tools available in every Ryvos installation:

Tool	Tier	Description
`bash`	T3	Execute shell commands. Supports any shell command with full stdin/stdout/stderr capture.
`read`	T0	Read file contents. Returns the full file or a specified line range.
`write`	T2	Write content to a file. Creates parent directories if needed.
`edit`	T2	Apply targeted edits to a file using search-and-replace.
`glob`	T0	Find files matching glob patterns (e.g., `*/.rs`, `src/*/.ts`).
`grep`	T0	Search file contents with regex patterns. Returns matching lines with context.
`memory_search`	T0	Search persistent memory using keywords or semantic queries.
`memory_write`	T0	Store a key-value pair in persistent memory.
`spawn_agent`	T3	Spawn a sub-agent for a specific task. Inherits security context.
`web_fetch`	T1	Fetch a URL and return the content (HTML, JSON, text).
`web_search`	T1	Search the web using the configured search provider.
`apply_patch`	T2	Apply a unified diff patch to one or more files.

Session Tools (5)

Manage agent sessions:

Tool	Tier	Description
`session_list`	T0	List recent sessions with IDs, timestamps, and message counts.
`session_history`	T0	Retrieve the message history of a specific session.
`session_send`	T1	Send a message to another active session.
`session_spawn`	T2	Create a new session with a specific prompt.
`session_status`	T0	Get the current session's status (turns, tokens, cost).

Memory Tools (5)

Persistent memory management:

Tool	Tier	Description
`memory_search`	T0	Search memory entries by keyword (BM25) or semantic similarity.
`memory_write`	T0	Store a key-value pair. Overwrites if the key already exists.
`memory_get`	T0	Retrieve a specific memory entry by exact key.
`memory_delete`	T0	Delete a memory entry by key.
`daily_log_write`	T0	Append to today's daily log file.

File System Tools (9)

File and directory operations:

Tool	Tier	Description
`file_info`	T0	Get file metadata: size, permissions, modified time, type.
`file_copy`	T1	Copy a file or directory.
`file_move`	T2	Move or rename a file or directory.
`file_delete`	T2	Delete a file or directory (with recursive option).
`dir_list`	T0	List directory contents with optional recursive listing.
`dir_create`	T1	Create a directory (with parents).
`file_watch`	T1	Watch a file or directory for changes.
`archive_create`	T1	Create a tar.gz or zip archive from files/directories.
`archive_extract`	T1	Extract a tar.gz or zip archive.

Git Tools (6)

Tool	Tier	Description
`git_status`	T0	Show working tree status (staged, unstaged, untracked).
`git_diff`	T0	Show diffs (staged, unstaged, or between commits).
`git_log`	T0	Show commit history with optional filters.
`git_commit`	T2	Stage files and create a commit with a message.
`git_branch`	T1	List, create, switch, or delete branches.
`git_clone`	T1	Clone a repository to a local directory.

Code & Development Tools (4)

Tool	Tier	Description
`code_format`	T1	Format code using the appropriate formatter (rustfmt, prettier, black, etc.).
`code_lint`	T1	Run linter on code (clippy, eslint, pylint, etc.).
`test_run`	T2	Run tests with the project's test framework (cargo test, npm test, pytest, etc.).
`code_outline`	T0	Extract code structure: functions, classes, types, imports.

Network Tools (4)

Tool	Tier	Description
`http_request`	T1	Make an HTTP request (GET, POST, PUT, DELETE, PATCH) with headers and body.
`http_download`	T1	Download a file from a URL to a local path.
`dns_lookup`	T0	Resolve a domain name to IP addresses.
`network_check`	T0	Check connectivity to a host and port.

System Tools (5)

Tool	Tier	Description
`process_list`	T0	List running processes with PID, name, CPU, and memory usage.
`process_kill`	T3	Kill a process by PID or name.
`env_get`	T0	Get the value of an environment variable.
`system_info`	T0	Get system information: OS, architecture, CPU, memory, disk.
`disk_usage`	T0	Show disk usage for a directory tree.

Data & Transform Tools (8)

Tool	Tier	Description
`json_query`	T0	Query JSON data using JMESPath expressions.
`csv_parse`	T0	Parse CSV data with filtering and column selection.
`yaml_convert`	T0	Convert between YAML and JSON.
`toml_convert`	T0	Convert between TOML and JSON.
`base64_codec`	T0	Encode or decode base64 data.
`hash_compute`	T0	Compute hash (SHA-256, SHA-512, MD5) of a string or file.
`regex_replace`	T0	Apply regex replacements on text.
`text_diff`	T0	Generate a unified diff between two texts or files.

Scheduling Tools (3)

Tool	Tier	Description
`cron_list`	T0	List all configured cron jobs with next fire times.
`cron_add`	T2	Add a new cron job with a schedule and prompt.
`cron_remove`	T2	Remove a cron job by name.

Database Tools (2)

Tool	Tier	Description
`sqlite_query`	T1	Execute a SQL query against a SQLite database file.
`sqlite_create_table`	T2	Create a table in a SQLite database.

Browser Automation Tools (5)

Headless browser control via Chromium:

Tool	Tier	Description
`browser_navigate`	T1	Navigate to a URL in the headless browser.
`browser_screenshot`	T1	Take a screenshot of the current page.
`browser_click`	T2	Click an element by CSS selector.
`browser_type`	T2	Type text into an input element.
`browser_extract`	T1	Extract text or HTML from elements matching a selector.

:::note Browser tools require Chromium or Chrome installed on the system. They use the chromiumoxide library for headless automation. :::

Viking Memory Tools (4)

Hierarchical memory operations (requires Viking server):

Tool	Tier	Description
`viking_search`	T0	Semantic search across Viking memory with tier selection (L0/L1/L2).
`viking_read`	T0	Read a specific memory path at a specific tier.
`viking_write`	T0	Write or update a memory entry (auto-generates L0/L1 summaries).
`viking_list`	T0	Browse the viking:// memory filesystem.

Google Workspace Tools (6)

Tool	Tier	Description
`gmail_search`	T1	Search Gmail messages by query.
`gmail_read`	T1	Read a specific Gmail message by ID.
`gmail_send`	T2	Send a Gmail message.
`gcal_list_events`	T1	List Google Calendar events for a date range.
`gcal_create_event`	T2	Create a Google Calendar event.
`gdrive_search`	T1	Search Google Drive files.

Notion Tools (4)

Tool	Tier	Description
`notion_search`	T1	Search Notion pages and databases.
`notion_read_page`	T1	Read a Notion page's content.
`notion_create_page`	T2	Create a new Notion page.
`notion_update_page`	T2	Update an existing Notion page.

Jira Tools (3)

Tool	Tier	Description
`jira_search`	T1	Search Jira issues using JQL.
`jira_create_issue`	T2	Create a new Jira issue.
`jira_update_issue`	T2	Update an existing Jira issue.

Linear Tools (3)

Tool	Tier	Description
`linear_search`	T1	Search Linear issues.
`linear_create_issue`	T2	Create a new Linear issue.
`linear_update_issue`	T2	Update an existing Linear issue.

Communication Tools (1)

Tool	Tier	Description
`notification`	T1	Send a notification to configured channels or the system notification service.

Security Tiers

Tiers are used for classification and audit purposes. The constitutional safety system handles execution decisions — no tool is blocked based on tier alone.

Each tool has an assigned security tier:

Tier	Level	Auto-Approved By Default	Examples
T0	Safe	Yes	`read`, `glob`, `grep`, `memory_search`
T1	Low	Yes	`web_fetch`, `http_request`, `git_clone`
T2	Medium	Approval required	`write`, `edit`, `git_commit`, `sqlite_create_table`
T3	High	Approval required	`bash`, `spawn_agent`, `process_kill`
T4	Critical	Requires explicit constitutional reasoning	Unparseable bash commands

Configure classification thresholds in config.toml:

[security]
auto_approve_up_to = "T1"    # Auto-approve T0 and T1

Tool Registry

All tools are registered in the ToolRegistry at startup. MCP tools are bridged with the naming convention mcp__{server}__{tool}. Skill-based tools use skill__{name}.

Next Steps

Productivity Integrations — Google, Notion, Jira, Linear setup
Custom Tools & Skills — Write your own tools
MCP Integration — Connect external tool servers