Om-Panel

Read File

Read a file from the Om-Panel or OM-Bot GitHub repository.

List Files

List files and folders in a directory of the GitHub repository.

Write File

Write or OVERWRITE a file in the GitHub repo with completely new content. Use this only for new files or full rewrites. For small/targeted changes to an existing file, prefer edit_file — it is faster and avoids large-payload failures. Set encoding="base64" to write BINARY files (png, jpg, ttf, jar…) — pass the base64 of the raw bytes; with the default utf-8 the bytes get mangled and the file is corrupted. Creates a commit — Railway will auto-deploy. Requires confirm_token.

Edit File

Make a targeted edit to an EXISTING file by replacing one exact string with another — like a find-and-replace. old_str must appear in the file EXACTLY ONCE (byte-for-byte, including whitespace/indentation) or the edit is rejected. Prefer this over write_file for any change smaller than a full-file rewrite: it is much faster, cheaper, and does not risk truncation on large files. Always read_file first to copy the exact text. Creates a commit — Railway will auto-deploy. Requires confirm_token.

Search Code

Search for a text string across files in the GitHub repo (like grep). Useful for finding where something is defined or used without listing and reading many files first. Note: GitHub indexing can lag a few minutes behind the latest commit.

Get Env Vars

List environment variable NAMES (not values, for security) configured on a Railway service. Useful for verifying a required var like GEMINI_API_KEY is actually set without guessing or asking the user to check manually.

Restart Service

Restart the latest Railway deployment for a service WITHOUT creating a new commit. Useful right after changing env vars. Requires confirm_token.

Discord List Channels

List channels in a Discord server (guild) the bot is in, with their IDs and types.

Discord List Roles

List roles in a Discord server (guild), with their IDs.

Discord Get Messages

Fetch recent messages from a Discord text channel, including attachment URLs (images) and embed image URLs. Useful for verifying what Ommy actually sees/found when reading a channel.

Discord Send Message

Send a message to a Discord text channel as OM-Bot. Useful for testing announcements/embeds without going through Discord. Requires confirm_token.

Repo Stats

Get aggregate stats for a GitHub repo in ONE call: total file count, total size, breakdown by top-level folder and by file extension. Use this instead of calling list_files repeatedly and summing manually — much cheaper. Uses the GitHub git tree API (single recursive fetch).

Get Actions Runs

Get recent GitHub Actions workflow runs (status, conclusion, commit, URL) for a repo. Useful for checking whether a CI build succeeded or failed after pushing changes — e.g. after editing an Android project without a Railway deployment.

Get Actions Run Logs

Get the raw log text for a GitHub Actions job — use this after get_actions_runs shows a failure to see the actual error. Defaults to the first failed job in the run if job_id is omitted. Returns only the tail of the log since full logs can be huge.

Trigger Actions Workflow

Manually trigger a GitHub Actions workflow_dispatch run without needing a new commit. Only works if the workflow file has "workflow_dispatch" configured as a trigger. Requires confirm_token.

Prune Artifacts

Delete old GitHub Actions artifacts for a repo, keeping only the N most recent (sorted by creation date). Use this when an upload fails with "Artifact storage quota has been hit" to free space immediately, or proactively to enforce a rolling window. Requires confirm_token.

Count Lines

Count actual source lines across a repo (not a byte estimate). Batches GitHub GraphQL to fetch all file contents at once. Returns total, per-folder breakdown, and top 10 largest files. Use ext=".all" to count every file type.

Get Deploy Status

Get Railway deployment status for Om-Panel, OM-Bot, Ommy-Antiraid or Mad-Plus.

Get Deploy Logs

Get build or runtime logs for a Railway deployment.

Query Db

Query or modify the Om League MongoDB database. Both Om-Panel and OM-Bot share the same DB. Useful collection names: drivers — race stats (wins, podiums, poles, races, wdc, doty) driverratings — PAC/CRA/DEF/OVT/CON/EXP ratings and averages driverreviews — community star reviews economies — coin balances and transaction history warns — user warnings jails — jailed users ommyusers — Ommy AI memory per user userprofiles — Om-Panel prof

Claude Notes

Claude's persistent task-continuation notes, rendered as a 3D graph on the /notes page (visible only to the Commander). WORKFLOW for Claude: - When resuming work or asked to "continue", call {action:"list"} first to see open tasks, then {action:"get"} on the relevant note. - When a task is left half-finished, call {action:"save"} with a clear title and what remains to be done. - 'save' upserts by title — same title updates the existing note. - In content, [[Another Note Title]] creates a graph