Skip to content
DotfilesDotfiles
Esc
↑↓navigate↵open⌘Jpreview
On this page

Agents

dot's agent surface: Code Mode tools, the MCP server, the skills and every operation with its access.

Agents reach dot three ways, all from the same command tree. Try Code Mode first, then MCP, then the CLI with --json.

Surface What it is
Code Mode dot agent tools --json, read by the OpenCode cli-tools plugin as the dot namespace
MCP dot mcp, a stdio server with the same tools; job-only ones are left out
Skills The dot-* skills in dotfiles-skills/, published through skills.sh.json

Install the skills with the Skills CLI:

npx skills add timmo001/dotfiles

Add the MCP server to a harness as a stdio server running dot mcp.

Operations

Write tools ask before they run unless a permission rule allows them. Tools that always ask never save an “always” answer. Job-only tools run through the jobs namespace, since they take longer than a tool call should.

Tool Command Access MCP
repo_search dot repo search Read Read-only
repo_list dot repo list Read Read-only
pr_queue dot pr queue Read Read-only
session_status dot session status Read Read-only
session_current dot session current Read Read-only
updates_status dot updates status Read Read-only
services_status dot services status Read Read-only
session_queue dot session queue Read Read-only
pr_reviews dot pr reviews Read Read-only
pr_watch dot pr watch Read Read-only
pr_list dot pr list Read Read-only
agent_lint dot agent lint Read Read-only
link_git dot link git Read Read-only
herdr_context dot herdr context Read Read-only
herdr_agents dot herdr agents Read Read-only
git_issues dot git issues Read Read-only
git_diff dot git diff Read Read-only
git_log_show dot git log show Read Read-only
report_list dot report list Read Read-only
skills_validate dot skills validate Read Read-only
skills_check dot skills check Read Read-only
services_run_logs dot services run logs Read Read-only
services_export dot services export Read Read-only
services_busy dot services busy Read Read-only
services_probe_syncthing dot services probe syncthing Read Read-only
services_probe_kopia dot services probe kopia Read Read-only
services_act dot services act Write, always asks Destructive
services_logs dot services logs Read Read-only
services_investigate dot services investigate --print Read Read-only
git_commit dot git commit Write Tool
agent_oxlint dot agent oxlint Read Read-only
herdr_repo_open dot herdr repo open Write Tool
omarchy_plugin_add dot omarchy plugin add Write Tool
omarchy_plugin_update dot omarchy plugin update --yes Write Tool
omarchy_plugin_remove dot omarchy plugin remove --yes --no-commit-offer Write, always asks Destructive
services_schedule_check dot services schedule check Read Read-only
homeassistant_status dot homeassistant status Read Read-only
homeassistant_logs dot homeassistant logs Read Read-only
homeassistant_stop dot homeassistant stop Write, always asks Destructive
snapshot dot snapshot Read Read-only
doctor dot doctor Read Read-only
report_run dot report run Job only Left out
services_start dot services start Write Tool
services_stop dot services stop Write Tool
session_send dot session send Write Tool
session_take dot session take Write Tool
session_remove dot session remove Write, always asks Destructive
herdr_model dot herdr model Write Tool
herdr_pane_move dot herdr pane move Write Tool
mcp_sync dot mcp sync Write Tool
agent_sync dot agent sync Write Tool
stow dot stow Write Tool
up dot up Write Tool
up_dotfiles dot up dotfiles Job only Left out
up_skills dot up skills Job only Left out
up_repos dot up repos Job only Left out
up_stow dot up stow Write Tool
up_tools dot up tools Job only Left out
up_plugins dot up plugins Write Tool
up_containers dot up containers Job only Left out
up_herdr dot up herdr Write Tool
up_agents dot up agents Write Tool
up_shell dot up shell Write Tool
updates_refresh dot updates refresh Write Tool
repo_induct dot repo induct --noninteractive Write Tool
reload dot reload Write Tool
skills_consumers_add dot skills consumers add Write Tool
skills_consumers_remove dot skills consumers remove Write, always asks Destructive
notes_capture_sync dot notes capture sync Write Tool
omarchy_shell_config dot omarchy shell config Write Tool
git_notifications_dismiss_dependencies dot git notifications dismiss dependencies Write Tool
git_notifications_dismiss_remaining dot git notifications dismiss remaining Write, always asks Destructive

Last updated on