### Custom Login Tool Example

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Changelog_v6.html

Example of how to pass Dude login credentials as variables for custom login tools. Ensure the path to the executable is correct.

```bash
D:/winbox.exe [Device.FirstAddress] [Admin.Name] [Admin.Password]
```

--------------------------------

### Reboot Device for Package Installation

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Server_on_hEX.html

Reboots the device to automatically install the uploaded Dude server package. Confirm the action when prompted.

```bash
/system reboot
```

--------------------------------

### Example Dude Client Secure Connection Shortcut

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Client_shortcuts.html

An example of a shortcut configuration for a secure connection to a Dude server. This demonstrates the actual path and credentials for a test server.

```bash
Target: "C:\Program Files (x86)\Dude\dude.exe" --connect 192.168.30.60 admin "" --secure 
Start in: "C:\Program Files (x86)\Dude"
```

--------------------------------

### Example Dude Server Status Output

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Server_on_CHR.html

An example of the output you would see when checking the Dude server status, indicating it is enabled and running.

```bash
[admin@MirkoTik] > dude print
         enabled: yes
  data-directory: disk1/dude-data
          status: running
```

--------------------------------

### Install Bun on Windows

Source: https://github.com/tikoci/rosetta/blob/main/README.md

Download and install the Bun JavaScript runtime on Windows systems using PowerShell. This is a prerequisite for running Rosetta locally.

```powershell
powershell -c "irm bun.sh/install.ps1 | iex"
```

--------------------------------

### Download DB and Print MCP Config

Source: https://github.com/tikoci/rosetta/blob/main/MANUAL.md

Use the --setup flag to download the database and print the MCP client configuration. This is the initial setup command for Rosetta.

```sh
./rosetta --setup    # downloads DB + prints MCP client config
```

--------------------------------

### Clone Rosetta and Install Dependencies

Source: https://github.com/tikoci/rosetta/blob/main/CONTRIBUTING.md

Clones the Rosetta repository from GitHub and installs its Node.js dependencies using Bun.

```sh
git clone https://github.com/tikoci/rosetta.git
cd rosetta
bun install
```

--------------------------------

### Setup Rosetta MCP Server and Client Configurations

Source: https://context7.com/tikoci/rosetta/llms.txt

Use `bunx @tikoci/rosetta --setup` to download the database and generate configuration snippets for various MCP clients. Rosetta can run as a stdio MCP server (default), an HTTP MCP server (`--http`), or an interactive terminal browser (`browse`).

```sh
# Quick start: download DB + print MCP client configs
bunx @tikoci/rosetta --setup

# Start as stdio MCP server (for Claude Code, VS Code Copilot, Claude Desktop)
bunx @tikoci/rosetta

# Claude Code one-liner
claude mcp add rosetta -- bunx @tikoci/rosetta

# VS Code settings.json

```

--------------------------------

### Install Bun on macOS / Linux

Source: https://github.com/tikoci/rosetta/blob/main/README.md

Download and install the Bun JavaScript runtime on macOS or Linux systems using curl. This is a prerequisite for running Rosetta locally.

```sh
# macOS / Linux
curl -fsSL https://bun.sh/install | bash
```

--------------------------------

### Add Winbox Tool

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/v3_Tools.html

Example of adding Winbox as a tool. It uses device variables for the first address, username, and password.

```shell
C:\\Users\\support\\Desktop\\winbox.exe "\[Device.FirstAddress\]" "\[Device.UserName\]" "\[Device.Password\]"
```

--------------------------------

### Start Rosetta HTTPS Server with TLS

Source: https://context7.com/tikoci/rosetta/llms.txt

Starts Rosetta with HTTPS enabled, requiring certificate and key files for secure communication. Ensure cert.pem and key.pem are valid.

```bash
bunx @tikoci/rosetta --http --tls-cert cert.pem --tls-key key.pem
```

--------------------------------

### Add Winbox Tool

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Tools.html

This example shows how to add Winbox as a custom tool, using both a direct path and the HOMEPATH environment variable. Ensure the correct path to winbox.exe is used.

```bash
C:\Users\support\Desktop\winbox.exe [Device.FirstAddress] [Device.UserName] "[Device.Password]"
```

```bash
%HOMEPATH%\Desktop\winbox.exe [Device.FirstAddress] [Device.UserName] "[Device.Password]"
```

--------------------------------

### Enable The Dude Server

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/MigrationToNewDude.html

Use this command to enable The Dude server after installation or reboot. Check its current status with '/dude print'.

```bash
/dude set enabled=yes
```

--------------------------------

### Install Rosetta with Bun

Source: https://github.com/tikoci/rosetta/blob/main/MANUAL.md

This command installs or updates the rosetta package using Bun. It automatically resolves the latest version and downloads necessary assets.

```bash
bunx @tikoci/rosetta
```

--------------------------------

### Import Dude DB (v6.34rc45+)

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/DB_import_export.html

Command to import The Dude database from a specified file path for builds starting with v6.34rc45. Includes progress feedback.

```bash
/dude import-db backup-file=(file_name_path)
```

--------------------------------

### Start Rosetta HTTP Server

Source: https://context7.com/tikoci/rosetta/llms.txt

Launches Rosetta as an HTTP server on a specified port and host. This is useful for shared network access or integration with services like ChatGPT.

```bash
bunx @tikoci/rosetta --http --port 8080 --host 0.0.0.0
```

--------------------------------

### Run Development Commands

Source: https://github.com/tikoci/rosetta/blob/main/CONTRIBUTING.md

Executes common development tasks including running tests, type checking, linting, performing preflight checks, and starting the MCP server in development mode.

```sh
bun test             # Run tests (in-memory SQLite, no DB needed)
bun run typecheck    # Type check
bun run lint         # Biome linter
make preflight       # All checks: clean tree, DB, typecheck, test, lint
bun run src/mcp.ts   # Start MCP server in dev mode
```

--------------------------------

### View Dude Log Entries

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Logs.html

Example log entries showing 'dude,event' indicating system events related to The Dude. These entries appear in the main Log section after enabling the 'dude' topic.

```log
11:31:06 dude,event 10.5.104.241: system,info device changed by admin 
11:32:50 dude,event 10.5.104.241: system,info changed email settings by admin 
11:33:21 dude,event Service disk on Termo_PowerCycle is now up (ok) 
11:34:40 system,info changed email settings by admin 
11:35:24 dude,event Service VNC-server-check on 10.5.8.160 is now up (ok) 
11:36:28 system,info,account user admin logged in from 10.5.104.252 via telnet 
11:37:13 system,info,account user admin logged in from 10.5.104.252 via telnet 
```

--------------------------------

### Get RouterOS Database Statistics

Source: https://context7.com/tikoci/rosetta/llms.txt

Use `routeros_stats` to retrieve database health statistics and coverage metadata. This helps verify corpus scope and discover available agent skill guides.

```json
{
  "name": "routeros_stats",
  "arguments": {}
}
```

```json
{
  "pages": 317,
  "sections": 2984,
  "properties": 4860,
  "callouts": 1034,
  "commands": 40182,
  "command_versions": 1670000,
  "devices": 144,
  "device_test_results": 2874,
  "changelogs": 18450,
  "videos": 518,
  "video_segments": 1890,
  "ros_versions": ["7.9", "7.10", "..."],
  "schema_version": 5,
  "skills": {
    "count": 8,
    "available": ["routeros-fundamentals", "container-setup", "qemu-chr", "netinstall", "..."],
    "note": "Community-created agent guides from tikoci/routeros-skills. Access via rosetta://skills/{name} resources."
  }
}
```

--------------------------------

### Install MikroTik Container Package

Source: https://github.com/tikoci/rosetta/blob/main/README.md

Installs the container package on MikroTik RouterOS. This action requires the router to reboot automatically.

```routeros
# Install the container package (router reboots automatically)
/system/package/update/check-for-updates duration=10s
/system/package/enable container
# Apply changes restarts the router
```

--------------------------------

### Install Optional System Dependency: yt-dlp

Source: https://github.com/tikoci/rosetta/blob/main/CONTRIBUTING.md

Installs yt-dlp, a tool for extracting YouTube transcripts, on macOS, Debian/Ubuntu, or any platform using pip.

```sh
brew install yt-dlp          # macOS
apt install yt-dlp           # Debian/Ubuntu
pip install -U yt-dlp        # any platform (pip)
```

--------------------------------

### Run Pre-commit Checks and CI Parity Tests

Source: https://github.com/tikoci/rosetta/blob/main/CONTRIBUTING.md

Use 'make preflight' for local checks like cleaning, typechecking, and linting. Use 'make verify' for CI parity tests, including contract tests and Phase 0 evaluation, which requires a populated database.

```sh
make preflight                       # Pre-commit: clean tree + DB + typecheck + lint + test
```

```sh
make verify                          # CI parity: like preflight but no clean-tree, adds contract tests + Phase 0 eval (requires populated DB)
```

--------------------------------

### Install Rosetta on MikroTik RouterOS

Source: https://context7.com/tikoci/rosetta/llms.txt

Installs Rosetta as an application on MikroTik RouterOS (v7.22+). This embeds Rosetta directly onto the router for local access and management.

```routeros
/app/add use-https=yes disabled=no yaml="name: rosetta
url-path: /mcp
auto-update: true
services:
  rosetta:
    image: ghcr.io/tikoci/rosetta:latest
    ports:
      - 9803:8080/tcp:web
"
```

--------------------------------

### Quick Setup Rosetta Locally with Bun

Source: https://github.com/tikoci/rosetta/blob/main/README.md

Run Rosetta on your workstation using Bun for local development. This command downloads the database and prints configuration snippets for MCP clients. The MCP server runs over stdio, requiring no network configuration.

```sh
bunx @tikoci/rosetta --setup
```

--------------------------------

### HTTP GET Request Probe Configuration

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Probes.html

Set up an HTTP GET probe to monitor the content of a host's HTTP response. The probe is successful only if the response content contains the specified string. This is useful for checking if a server is responding with required data.

```text
GET /compare HTTP/1.1
Host: <MONITORED DEVICE>:9000


```

--------------------------------

### Import Dude DB (Up to v6.34rc44)

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/DB_import_export.html

Command to import The Dude database from a specified file path for builds up to v6.34rc44.

```bash
/dude import-db file=(file_name_path)
```

--------------------------------

### Dude Client Plain Connection Shortcut

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Client_shortcuts.html

Use this format for a shortcut to connect to a Dude server in plain connection mode. Replace placeholders with your server's IP/DNS, username, and password.

```bash
Target: (disk id):\(path_to_dude)\dude.exe --connect (IP/DNS) (user) (pass)
Start in: (disk id):\(path_to_dude)
```

--------------------------------

### Dude Client Secure Connection Shortcut

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Client_shortcuts.html

Use this format for a shortcut to connect to a Dude server using a secure connection. Append '--secure' to the command. Replace placeholders with your server's IP/DNS, username, and password.

```bash
Target: (disk id):\(path_to_dude)\dude.exe --connect (IP/DNS) (user) (pass) --secure \nStart in: (disk id):\(path_to_dude)
```

--------------------------------

### Query Rosetta Database with SQLite

Source: https://github.com/tikoci/rosetta/blob/main/MANUAL.md

Example of querying the `pages_fts` table for pages matching 'DHCP lease' using the `sqlite3` command-line tool.

```sh
sqlite3 ros-help.db "SELECT title, url FROM pages_fts WHERE pages_fts MATCH 'DHCP lease' ORDER BY rank LIMIT 5;"
```

--------------------------------

### Configure Claude Desktop for Rosetta

Source: https://github.com/tikoci/rosetta/blob/main/README.md

Add Rosetta as an MCP server in the Claude Desktop configuration file. Ensure to restart Claude Desktop after editing the configuration.

```json
{
  "mcpServers": {
    "rosetta": {
      "command": "bunx",
      "args": ["@tikoci/rosetta"]
    }
  }
}
```

--------------------------------

### Export Dude DB (v6.34rc45+)

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/DB_import_export.html

Command to export The Dude database to a specified file path for builds starting with v6.34rc45. Includes progress feedback.

```bash
/dude export-db backup-file=(file_name_path)
```

--------------------------------

### Search and Get Dude Documentation

Source: https://context7.com/tikoci/rosetta/llms.txt

Tools for searching (`routeros_dude_search`) and retrieving (`routeros_dude_get_page`) archived Dude network monitor documentation from the old MikroTik wiki.

```json
// Search
{
  "name": "routeros_dude_search",
  "arguments": { "query": "SNMP probes device discovery", "limit": 5 }
}
```

```json
// Get full page
{
  "name": "routeros_dude_get_page",
  "arguments": { "id": "Device_discovery", "max_length": 16000 }
}
```

--------------------------------

### Import Data from SQL File

Source: https://github.com/tikoci/rosetta/blob/main/dude/pages/Malformed_db_repair.html

Imports data from the objs.sql file into the newly created dude.db SQLite database. This step restores the configuration data.

```bash
.read objs.sql
```

--------------------------------

### Rosetta Terminal Browser One-Shot Command Example

Source: https://context7.com/tikoci/rosetta/llms.txt

Executes a specific changelog search command non-interactively using the `--once` flag, suitable for piping into other commands.

```bash
bunx @tikoci/rosetta browse --once "cl 7.22..7.23beta2 breaking"
```