Field guide/Reference

Commands

Everything Deskfish adds to the command palette.

Open the command palette (Ctrl+Shift+P, or ⌘⇧P on macOS) and type Deskfish to see these. Most of them are also reachable from the sidebar, which is the normal way to use Deskfish; the commands exist for keyboard people and for keybindings.

CommandWhat it does
Deskfish: Open Desktop ViewOpens the Desktop tab with the live view of the tank. Same as the Desktop chip
Deskfish: Turn Desktop On / OffToggles the tank. Same as the power button
Deskfish: Turn Desktop OnStarts the tank (building the image the first time)
Deskfish: Restart DesktopTurns the tank off and on again. A running task is stopped first. Also under the menu
Deskfish: Turn Desktop OffStops a running task if there is one, then shuts the tank down cleanly
Deskfish: Set LLM API KeyAsks for the API key and stores it in the operating system's keychain. Leave it empty to clear the stored key. Same as the key chip
Deskfish: Stop AgentEnds the current task. Same as the Stop button
Deskfish: Choose Model…Picks where the model comes from (Anthropic direct, OpenRouter, xAI, Ollama, LiteLLM, another endpoint, or the demo) and which model, then asks for a key if that provider has none. The Change button next to Model does the same
Deskfish: Past Chats…Lists saved chats, newest first; open a transcript, or continue one in a new chat. The clock icon in the sidebar's title bar
Deskfish: Delete Past ChatsRemoves every saved transcript after a confirmation; journal, facts and self are untouched. Also under the menu
Deskfish: New ChatCloses the current chat's transcript and starts a fresh conversation, stopping a running task if there is one. The desktop is left as it is. Same as the + in the sidebar's title bar
Deskfish: Edit Memories (facts)Opens the agent's fact file in an editor tab, one fact per line. Also under the menu
Deskfish: Forget All Memories (facts)Empties the fact file after a confirmation; the journal and the self file are untouched. Also under the menu
Deskfish: Who She IsRead-only view of the agent's self file, the page it writes about itself. Also under the menu
Deskfish: Open Her JournalOpens the journal: one line per finished task and per note the agent left itself. Also under the menu
Deskfish: Open Her PlaybooksOpens the playbooks: the how-to notes the agent wrote for itself per site or task. Also under the menu
Deskfish: Edit Her CharterOpens the charter, the maker's ten commitments with reasons that sit above the agent's self page, starting from the default. Also under the menu
Deskfish: Schedule a Task…Asks when (once, daily, weekly, every N minutes) and what; the task starts itself at that time while VS Code is open. See Schedules. Also under the menu
Deskfish: Scheduled Tasks…Lists the schedules with their next time and last outcome; run one now or remove it. Also under the menu
Deskfish: Let Her ReflectRuns a reflection now: the agent, alone with its notes, saves facts and may revise its self file. Also under the menu
Deskfish: Export Her Memory…Saves facts, self file (with history) and journal to one JSON file. Also under the menu
Deskfish: Import Her Memory…Restores all three from such a file, after a confirmation. Also under the menu
Deskfish: Save a File from the Desktop…Lists the files in the tank's Downloads folder and saves the one you pick to your computer
Deskfish: Install Podman…Opens a terminal with the installation command for this system. Same as the Install button on the setup card
Deskfish: Show LogOpens the Deskfish output channel: every step of every task, unfolded
Deskfish: Open DocumentationOpens this documentation in your browser

Keybindings#

None are set by default. To add your own, open Preferences: Open Keyboard Shortcuts and search for deskfish; the command identifiers are deskfish.openDesktop, deskfish.toggleDesktop, deskfish.startDesktop, deskfish.stopDesktop, deskfish.setApiKey, deskfish.stopAgent, deskfish.newChat, deskfish.editMemory, deskfish.clearMemory, deskfish.showSelf, deskfish.openJournal, deskfish.openPlaybook, deskfish.editCharter, deskfish.pastChats, deskfish.deletePastChats, deskfish.reflect, deskfish.exportMemory, deskfish.importMemory, deskfish.saveFile, deskfish.installRuntime, deskfish.showLog and deskfish.openDocs.

Deskfish v0.1.0 · Apache 2.0Back to the little fish