Tool reference (182 tools)

Generated from the live registry (bench/dump_tools.py --json), so the list on this page is the list the model is handed.

55 core tools and 31 additional groups. The agent selects relevant tool groups per turn; the complete registry is not necessarily advertised at once. Descriptions below come from code and do not prove account connectivity.

Registry membership, configured credentials and a verified external result are separate evidence. Confirmation and individual handler restrictions still apply. See Architecture.

Core — advertised on every turn (55)

Always in the model's tool surface: memory, vault, web, Telegram, music, PC control, reminders, routines, utilities. These are the tools a turn can need without warning, so they are never lazy.

Tool	Module	What it does
`add_task`	`tasks`	Add a task to the owner's to-do list, with an optional description, priority and deadline.
`browse_web`	`web`	Open a real headless browser to navigate and extract from a page that needs interaction or JavaScript.
`browser`	`browser`	Drive a real visible web browser on the owner's screen.
`cancel_reminder`	`reminders`	Cancel ONE pending reminder by its id (a short prefix from list_reminders works).
`check_telegram`	`telegram`	Summarise the owner's UNREAD Telegram direct messages.
`complete_task`	`tasks`	Mark a to-do task as done (identify it by a word from its title or its id).
`convert`	`utility`	Convert a quantity between units of length, mass, volume or temperature.
`crypto_price`	`utility`	Live cryptocurrency price by ticker (btc, eth, sol…) with its 24-hour change.
`define_word`	`utility`	Dictionary definition of a single ENGLISH word, with its part of speech.
`delete_task`	`tasks`	Delete a task from the to-do list (identify it by a word from its title or its id).
`diagnose`	`diagnose`	Report Mushegh's OWN recent failures — errors and warnings from every process (the laptop's voice edge and pc_agent, and this brain), with the subsystem that produced each.
`file_op`	`system`	Create or delete files and folders on the owner's PC, or list a folder.
`forget`	`memory`	Delete a remembered subject from long-term memory — every matching fact, its embedding, its relations and the journal lines about it, then verified by asking again (37.F3).
`fx_rate`	`utility`	Convert money between two currencies at the latest ECB reference rate.
`invoke_skill`	`skills`	RUN a built-in composable skill — its steps (tool calls / spoken lines) fire in order.
`list_reminders`	`reminders`	List pending reminders with each one's next fire time and short id.
`list_skills`	`skills`	List your available skill playbooks (coding, self-improvement, your own architecture, languages…).
`list_tasks`	`tasks`	List the owner's to-do tasks (most urgent first, with priority, deadline and progress) plus any background jobs Mushegh is currently running.
`mark_telegram`	`telegram`	Change a chat's read state.
`media_pause`	`system`	Pause (or resume) whatever media is playing on the owner's PC — a browser video, Spotify, VLC, etc.
`news_brief`	`utility`	Top Hacker News headlines, or HN stories matching a topic.
`now_playing`	`localplay`	What track is currently playing OUT LOUD on the desktop, if any.
`open_app`	`system`	Launch an application on the owner's PC by name or path ('notepad', 'spotify', 'code', 'explorer').
`open_url`	`system`	Open a URL in the owner's default browser on his PC (e.g.
`plan_today`	`routines`	The owner tells you WHEN a standing commitment happens TODAY — 'I'll train at noon', 'training at 19:00', 'reading around 21:30'.
`play_music`	`music`	Play a song or artist.
`process_op`	`system`	Manage processes on the owner's PC: list (optionally filtered by name), kill by name or pid, start a new process/app, or SUSPEND/RESUME an app to pause then continue it without losing its state (e.g.
`read_chat`	`telegram`	Read aloud the last messages of a specific Telegram chat — whether or not they're unread — WITHOUT marking them seen (the sender still sees them as just delivered).
`read_journal`	`memory`	Read the daily journal of past sessions.
`read_skill`	`skills`	Open one of your reference playbooks by name (e.g.
`read_vault_note`	`vault`	Read the full text of a specific vault note by its relative path (as returned by search_vault, e.g.
`recall`	`memory`	Search across ALL memory layers — L1 learned facts, L2 journal entries, L3 vault notes, L5 semantic — for what you know about a topic or person.
`remember`	`memory`	Save a durable fact to long-term memory so you recall it in future sessions.
`resolve_contact`	`contacts`	Resolve a person's NAME to their email / Telegram / phone before sending or drafting to them.
`routine`	`routines`	Run a named behavioural routine (not a password protocol).
`run_powershell`	`system`	Run a PowerShell command on the owner's PC and get the output.
`run_protocol`	`protocols`	Run a named protocol — a privileged routine that requires the owner's password.
`save_contact`	`contacts`	Remember a person's email / Telegram / phone so they can be messaged by NAME in future sessions.
`scrape_url`	`web`	Fetch a single web page and return its main text as clean Markdown.
`search_vault`	`vault`	Search the owner's Obsidian knowledge vault (his notes, project charters, agent docs, decisions) for a topic and get the top matching notes with snippets.
`self_health`	`routines`	Report on your own health — vault readability, cache backend, reminder host — and your current mode.
`send_push`	`notify`	Send a push notification to the owner's phone (ntfy).
`send_telegram`	`telegram`	THE way to message a real person on the owner's behalf — sends AS the owner from his own Telegram account.
`set_home_location`	`routines`	Set or report the owner's CURRENT home location (a changeable variable — e.g.
`set_reminder`	`reminders`	Set a reminder that will be spoken (and pushed to his phone) when it fires.
`stock_price`	`utility`	Latest stock/ETF quote by ticker, with its move on the day.
`stop_music`	`localplay`	Stop music that's playing OUT LOUD on the desktop (a local track, e.g.
`task_status`	`tasks`	Report the status/progress of one task by a word from its title (or its id) — a to-do item or a running background job.
`telegram_music`	`telegram`	Play from the owner's personal Telegram music playlist.
`telegram_threads`	`telegram`	List the forum topics in a Telegram group, so the owner can name one.
`update_task`	`tasks`	Update a task on the to-do list — change its description, priority or deadline, or record progress (a percent and/or a short note).
`weather`	`utility`	Weather for a place — current conditions, tomorrow, or the week ahead.
`web_search`	`web`	Search the web for current information (news, facts, how-tos, prices) and get a synthesized answer with sources.
`whats_waiting`	`inbox`	Everything waiting on the owner across every channel at once — unread email, unread Telegram chats, and actions awaiting his approval — deduplicated by thread.
`wiki_lookup`	`utility`	A short Wikipedia summary of one topic, person or thing.

Activity (3)

Screen time, what you are working on now, and the switch that turns the tracking off.

Tool	Module	What it does
`activity_tracking`	`activity`	Turn the local activity/screen-time tracking on or off, or report its status.
`current_activity`	`activity`	What the owner is doing on the computer right now (the foreground app + window, or how long he's been idle).
`screen_time`	`activity`	Report how long the owner has spent on the computer today (or a past day), broken down by app and category.

Approvals (3)

Approve or reject the outward steps that autonomous work deferred to you.

Tool	Module	What it does
`approve_action`	`approvals`	APPROVE a queued action and execute it now.
`list_approvals`	`approvals`	List the outward actions Mushegh deferred during autonomous work and queued for the owner's approval.
`reject_action`	`approvals`	Reject a queued action so it never runs.

External apps (Composio) (2)

250+ apps — GitHub, Slack, Drive and the rest — behind two meta-tools, so the catalogue stays two entries instead of hundreds.

Tool	Module	What it does
`composio_find_tools`	`composio`	Discover which Composio tool to call for a task.
`composio_run_tool`	`composio`	Execute a specific Composio app tool by its exact slug (from composio_find_tools) with its arguments.

Audio output (3)

Which speaker or headphones Mushegh talks through, and how loud.

Tool	Module	What it does
`list_audio_outputs`	`audioout`	List the audio output devices on the laptop and say which one is in use.
`set_volume`	`audioout`	Change how loud the laptop is, or mute it — for whatever is playing.
`switch_audio_output`	`audioout`	Switch which device Mushegh SPEAKS through on the laptop — headphones/AirPods or the built-in speakers.

brief (1)

Tool	Module	What it does
`read_brief`	`brief`	Read out the owner's brief when he asks for it: 'morning' (past-due tasks, due today, important mail) or 'evening' (what he finished, what slipped, what tomorrow needs).

Camera (3)

Webcam vision and visual presence: whether you are at the desk, and who.

Tool	Module	What it does
`enroll_owner_face`	`camera`	Learn the owner's face locally (stored on disk, never uploaded) so future 'visual_presence' checks can recognise them.
`look_around`	`camera`	SEE through the laptop camera and describe/answer about what's physically in front of the owner.
`visual_presence`	`camera`	Check whether the owner is physically at the desk using the camera (local face detection/recognition only — no image is sent anywhere).

YouTube channels (3)

List a channel, play its latest, or pick something at random from it.

Tool	Module	What it does
`list_channel_videos`	`channels`	List recent videos from a YouTube channel (e.g.
`play_latest_from_channel`	`channels`	Open the most recent video from a YouTube channel in the owner's browser.
`play_random_from_channel`	`channels`	Pick a random recent video from a YouTube channel and open it in the owner's default browser.

Coaching (5)

Skill reviews and progress in a field you are learning.

Tool	Module	What it does
`list_coaching`	`coaching`	List the fields Mushegh is actively coaching, with each one's level and current streak.
`record_skill_review`	`coaching`	Record the result of a skill review: a 1-10 score and a short note on how it went.
`set_skill_level`	`coaching`	Set or correct the owner's level in a coaching field (e.g.
`skill_progress`	`coaching`	Report the owner's progress in a coaching field: level, recent average score, trend, streak.
`start_skill_check`	`coaching`	Begin a coaching review/quiz for one of the owner's focus fields (e.g.

Coding (13)

Repo-scoped self-improvement: read and write source, run tests, lint, reversible git.

Tool	Module	What it does
`create_github_issue`	`coding`	File a GitHub issue in ONE step — use directly when the owner says 'open an issue', 'file a bug', 'create a GitHub issue about X'.
`git_commit`	`coding`	Commit your changes (reversible).
`git_diff`	`coding`	Show the line-by-line diff of uncommitted changes, optionally for one path.
`git_log`	`coding`	Show recent commits, one per line (default 10, max 50).
`git_new_branch`	`coding`	Create a branch and switch to it, keeping master clean before a self-improvement change.
`git_push`	`coding`	Push the current branch to GitHub's origin remote.
`git_revert`	`coding`	Undo a commit by creating a NEW revert commit (history is preserved, nothing is lost).
`git_status`	`coding`	Show the working-tree status of the owner's repo: current branch plus changed and untracked files.
`lint`	`coding`	Run ruff over the code (default: src and bench) and report what it flags.
`list_source`	`coding`	List the files and folders in one directory of the owner's repo (repo-relative).
`read_source`	`coding`	Read one of your own project source files (repo-relative path).
`run_tests`	`coding`	Run the full Mushegh test suite (bench/run_all_tests.py).
`write_source`	`coding`	Write/replace one of your own source files (repo-relative).

Compute (1)

Exact maths and hard facts through Wolfram Alpha, instead of a plausible-sounding guess.

Tool	Module	What it does
`compute`	`wolfram`	EXACT math, unit conversion, dates, physics, finance formulas and curated facts via Wolfram Alpha — use instead of guessing any non-trivial number ('compound interest on 5k at 4% for 10 years', 'convert 180 lbs to kg', 'sunset time in Berlin today').

council (3)

Tool	Module	What it does
`council_build`	`council`	Hand one coding seat a goal and let it work it through: plan, implement, run the gates, and re-instruct with every failure until the work is accepted or the round budget runs out.
`council_convene`	`council`	Seat several coding CLIs in their own git worktrees on one task, let them each answer while seeing the others' answers, and return the decision System One reaches from them.
`council_roster`	`council`	U's development council: which of the installed coding CLIs can actually answer, which are blocked and on exactly which missing API key, and which are not drivable on this machine at all.

Day shape (4)

Draft routines from what you actually do, and say when a day does not hold together.

Tool	Module	What it does
`adopt_routines`	`day_shape`	Install the routines previously proposed, after the owner has agreed to them.
`day_clashes`	`day_shape`	Check a day's calendar for double-bookings, journeys with no travel time, and long runs with no break.
`propose_routines`	`day_shape`	Draft the owner's daily routines from the activity Mushegh has actually observed, and read them back with the evidence for each.
`recommend_next`	`day_shape`	What the owner should work on next, chosen from his own open to-dos by a stated rule — overdue first, then due soonest, then work serving an objective he is driving, then priority.

Documents (5)

Open a local document and answer questions grounded in it.

Tool	Module	What it does
`ask_document`	`documents`	Ask a question about the currently-open document; returns the most relevant passages to answer from.
`close_document`	`documents`	Close the currently open document and drop its temporary index.
`create_document`	`documents`	Write a real document and put it where it belongs — the ONLY way to create one.
`find_document`	`documents`	Find a document YOU wrote earlier — 'the note you wrote yesterday about the farm', 'that decision record', 'what have you written lately'.
`read_document`	`documents`	Open a LOCAL document (text, Markdown, code, CSV, JSON; PDF if a reader is installed) into a temporary index so you can answer questions grounded in it.

Home (11)

Home Assistant control and the Telegram music-room voice chat.

Tool	Module	What it does
`ha_backup`	`smarthome`	Make a full Home Assistant backup right now (safe, changes nothing).
`ha_call`	`smarthome`	Call a Home Assistant service to control a device: domain + service (+ optional entity).
`ha_maintenance`	`smarthome`	Check the home system's own health: Home Assistant version, updates waiting, when it last backed up, internet connection, offline devices ('how is the house', 'any updates for home assistant', 'is the backup current?').
`ha_offline`	`smarthome`	List the smart-home devices Home Assistant cannot reach right now, by name ('is anything offline?', 'which bulbs are dead?', 'check the devices').
`ha_state`	`smarthome`	Read the current state of a Home Assistant device by entity id ('is the front door locked?', 'is the living room light on?').
`housekeeping`	`smarthome`	Turn housekeeping on or off (S52): lights off and heating to the setback when the house is empty, and a once-per-cycle 'finished' for named appliances.
`play_in_music_room`	`voicechat`	Stream a song into the owner's 'Mushegh Music Room' Telegram voice chat so it plays live on his PHONE (he joins that voice chat to listen).
`presence_automation`	`smarthome`	Turn the presence-driven scenes on or off, or set which scene runs when the owner arrives at or leaves the desk ('presence automation off').
`run_scene`	`smarthome`	Run one of the owner's named scenes ('bed', 'leaving', 'focus') - several devices with one command.
`save_scene`	`smarthome`	Save a named scene as a list of device actions.
`stop_music_room`	`voicechat`	Stop playback and LEAVE the Telegram Music Room voice chat.

hud (1)

Tool	Module	What it does
`control_hud`	`hudui`	Control the owner's spatial HUD after a voice request.

Macros (6)

Saved sequences of tool calls, and if-then rules that fire them.

Tool	Module	What it does
`define_macro`	`macros`	Save (or update) a named macro — a reusable sequence of steps.
`delete_macro`	`macros`	Permanently delete ONE saved macro by name so it can no longer be run.
`if_then`	`macros`	Conditional flow: if `condition` is true, run `then_steps`, else run `else_steps`.
`list_automations`	`macros`	List EVERYTHING Mushegh runs on his own — background loops, scheduled reminders and saved macros — with when each last ran, when it runs next, and how it went.
`list_macros`	`macros`	List every saved macro with its step count and description.
`run_macro`	`macros`	Execute a saved macro by name, running each step in order and returning a transcript.

Money (3)

Reads your ledger and values it. It never moves anything — there is no write path.

Tool	Module	What it does
`ask_ruben`	`ruben`	Delegate ANY money matter to Ruben, the owner's finance agent: finances, cash, spending, salary, transactions, transfers, investments, equity, funds, assets, property, crypto, taxes, budgets, subscriptions, recommendations.
`ruben_send_transcript`	`ruben`	Have Ruben send the full transcript of one of his sessions to the owner's Telegram, through Ruben's own bot.
`ruben_sessions`	`ruben`	List the recent Ruben sessions Mushegh started, newest first, to pick one up again ('continue the tax conversation from yesterday').

Objectives (8)

Multi-day goals Mushegh actively drives, with a dated progress log and honest stall reporting.

Tool	Module	What it does
`assign_objective`	`objectives`	Hand Mushegh a MULTI-DAY objective/goal to OWN and drive across days (not a one-off task).
`complete_objective`	`objectives`	Mark a multi-day objective DONE so Mushegh stops driving it.
`drop_objective`	`objectives`	ABANDON a multi-day objective unfinished so Mushegh stops driving it.
`list_objectives`	`objectives`	List the multi-day objectives Mushegh is currently driving, with each one's latest progress.
`objective_review`	`objectives`	Review every objective at once: what is moving, what has stalled and why, and which of the owner's open tasks serve which objective.
`objective_status`	`objectives`	Report progress on ONE named multi-day objective, including anything waiting on the owner's approval.
`set_milestone`	`objectives`	Put a dated milestone on a multi-day objective, or mark one reached.
`set_objective_hours`	`objectives`	Record how many hours a week the owner means to give one objective ('I can do 5 hours a week on the thesis').

Office (9)

Gmail, Google Calendar and Notion — including the task list, which is canonically Notion.

Tool	Module	What it does
`create_event`	`calendar`	Create a Google Calendar event.
`draft_email`	`gmail`	Save a Gmail draft WITHOUT sending it, so the owner can review first.
`list_events`	`calendar`	List Google Calendar events.
`notion_append`	`notion`	Append a paragraph of text to the end of an existing Notion page (a WRITE).
`notion_comment`	`notion`	Post a comment on a Notion page (a WRITE, visible to anyone sharing it).
`notion_read_page`	`notion`	Read the text content of one Notion page by its id.
`notion_search`	`notion`	Search the owner's Notion (only pages shared with the integration) for a page or database.
`read_email`	`gmail`	Read the owner's Gmail — unread by default, or a Gmail search query (e.g.
`send_email`	`gmail`	Send an email via Gmail.

osint (15)

Tool	Module	What it does
`breach_check`	`osint_advanced`	Check if an email has been exposed in known data breaches.
`business_lookup`	`osint_advanced`	Get information about a business or company.
`convert_currency`	`osint`	Convert an amount from one currency to another using live exchange rates.
`dns_lookup`	`osint_person`	Look up DNS records (A, AAAA, MX, TXT, CNAME, NS) for a domain.
`email_verify`	`osint_person`	Verify an email address format and check domain validity, MX records, and SMTP.
`github_profile`	`osint_advanced`	Get detailed information about a GitHub user profile.
`hash_lookup`	`osint_advanced`	Look up file hashes in threat intelligence databases.
`ip_geolocate`	`osint`	Geolocate an IP address to find its country, city, ISP, and coordinates.
`phone_info`	`osint_person`	Get information about a phone number (country, carrier, type).
`reverse_ip_lookup`	`osint_advanced`	Find all domains hosted on the same IP address or server.
`search_arxiv`	`osint`	Search for academic papers on arXiv.org.
`ssl_cert_info`	`osint`	Get SSL certificate information for a domain from Certificate Transparency logs.
`username_search`	`osint_person`	Check if a username is available across multiple platforms (GitHub, Twitter, Instagram, etc.).
`website_info`	`osint_person`	Extract metadata and information from a website (headers, technologies, SSL, title).
`whois_lookup`	`osint`	Look up domain registration information (WHOIS).

Phone (1)

Real phone calls through Twilio. Unconfigured by default, and he says so rather than pretending.

Tool	Module	What it does
`place_call`	`phone`	PLACE A REAL PHONE CALL to a number and speak a message on the owner's behalf — 'call the restaurant and book a table', 'ring my brother and tell him X', relay a code.

Places (2)

Live travel time and place search through Google Maps.

Tool	Module	What it does
`find_place`	`maps`	Find real places — restaurants, shops, gyms, addresses — with address, distance and opening hours.
`travel_time`	`maps`	Travel time by car, on foot, by bike or by public transport (with the lines and departure times) — 'how long to the airport now', 'when should I leave for X', 'how do I get there by train'.

Privacy (2)

What Mushegh stores about you, for how long, and how to make him forget it.

Tool	Module	What it does
`data_retention`	`privacy`	The full store-by-store table: what each holds and how long it is kept.
`what_you_know`	`privacy`	Report every store Mushegh keeps about the owner — how many, how large, which expire and which are kept indefinitely, and which never leave this laptop.

reading (1)

Tool	Module	What it does
`book`	`bookroom`	Read, price or summarise a BOOK (EPUB or PDF) with the owner's own Bookroom summarizer.

Relationship (3)

Sensitivities, running jokes and how things stand between you — read before he chooses a tone.

Tool	Module	What it does
`note_running_joke`	`relationship`	Remember a running joke or shared reference so Mushegh can call back to it later.
`note_sensitivity`	`relationship`	Record a topic the owner wants handled gently / carefully from now on ('that's a sore subject', 'go easy on the money stuff').
`relationship_status`	`relationship`	Report how things stand relationally — the owner's recent mood, topics to handle gently, and running jokes ('how am I doing', 'read the room').

Screen (3)

Screenshot and read what is on the display — armed only when you ask him to look.

Tool	Module	What it does
`describe_screen`	`multimodal`	SEE and describe the laptop screen using vision (not just OCR).
`read_screen_text`	`multimodal`	OCR the most recent laptop screenshot and return extracted text.
`screenshot_screen`	`multimodal`	Take a screenshot of the laptop screen and save it to a PNG path.

Stock (2)

What you have in the house and when it runs out.

Tool	Module	What it does
`check_stock`	`stock`	How much of something the owner has, and how long it will last at the rate it has been used.
`update_stock`	`stock`	Record stock arriving or being used.

tactical (1)

Tool	Module	What it does
`situation_report`	`tactical`	The standing picture in one answer: where he is and which modes are on, devices that are on/open/unlocked/offline, the next calendar commitment, and anything degraded in Mushegh itself — each with its source and age.

transit (4)

Tool	Module	What it does
`transit_carriage`	`transit`	Carriage formation for a named train and departure time — which coach is the bistro/cafe car, and where it stops.
`transit_delay_reason`	`transit`	Why a train is delayed, from DB's internal station display — 'Signalstörung', 'Verspätung eines vorausfahrenden Zuges' and so on.
`transit_departures`	`transit`	Live departure board for ANY German station or Cologne KVB stop — real delays, cancellations and platform changes.
`transit_journey`	`transit`	Route from A to B across the whole network — long-distance, regional and Cologne Stadtbahn — with departure time, arrival time, changes and fare.

Undo (2)

Roll back the last reversible action, or list what can still be undone.

Tool	Module	What it does
`list_recent_actions`	`undo`	Show the log of recent reversible actions — the last 8 things undo_last could roll back.
`undo_last`	`undo`	Roll back the most recent reversible action (file create, reminder, calendar event, etc.).

Vitals (4)

Sleep, steps and heart rate from an Apple Health export — no API, no key, no cloud project.

Tool	Module	What it does
`activity_summary`	`fitness`	The owner's steps and average heart rate TODAY from their wearable via Google Fit.
`import_health`	`fitness`	Read a health export the owner has saved: a raw .fit file from the Garmin watch (GARMIN/Monitor over USB) or an Apple Health export.xml.
`sleep_summary`	`fitness`	How the owner SLEPT last night (duration, wake time) from their wearable via Google Fit — 'how did I sleep', wellbeing checks.
`vitals_trend`	`fitness`	One health measure over recent days, from imported data — steps, sleep, resting heart rate, weight.

Safety. Reads run freely; outward or destructive actions (send, delete, spend, lock, write to an external app) are confirm-gated in code, not in the prompt — see Security. A bare recipient name is resolved to a real address before that gate, so what you are asked to approve names the address it will actually go to.

Every tool here is exercised by a test. A tool nothing uses and nothing checks is catalogue tokens spent on code no one is looking at. The sweep that enforces it found one that had never worked: written as a synchronous function in a registry the agent awaits, it had answered with a type error since the day it shipped, and nothing noticed because nothing called it.