~/dune

The Dune agent lives in the workbench, not in a browser tab. It reads your repo, edits files, runs the shell, and hands work to subagents, all inside permission rules you set. Every edit is checkpointed, so nothing it does is permanent until you keep it.

4built-in modes
18subagent roles
20+agent tools
7dreaming passes
01 / 06

Pick how much the agent may do. Ask mode answers questions and never touches files. Agent mode edits and runs tools. Plan mode writes a checklist first and is read-only until you approve it. Debug mode hunts a bug down from the evidence. Projects can add their own modes as Markdown files.

  • Plan mode can't write files or run a shell, whatever the permission rules say
  • Custom modes live in .dune/modes/*.md, created with /create-mode
  • One Hypery sign-in covers chat, inline completion and cloud workspaces
Agent & plan mode guide
chat — plan mode
you › add a status-bar accent token to the theme model
dune › PLAN · 4 steps
[x] read internal/shared/themeModel.tish
[x] add statusBar.accent to the token table
[ ] regenerate style.css (gen:dune-css)
[ ] run the CSS guard scripts
approve plan? [ build ] [ edit ]
02 / 06

Big tasks split up. The agent hands parts of the job to subagents that run in parallel, each with its own role, its own context and its own permission rules. The chat shows them in one grouped card, so you can follow every thread without losing the main one.

  • 18 built-in roles: implementer, tester, code-reviewer, security-reviewer, debugger, refactorer, docs-writer, researcher, planner and more
  • Define your own in .dune/agents/ or with /create-subagent
  • Child sessions report back to the parent, which merges the results
chat — subagents
▸ 3 subagents working
implementer editing src/billing/seats.ts …
tester writing seats.test.ts …
security-review read-only · reviewing the diff
✔ tester 12 passed, 0 failed
03 / 06

Each tool has a rule. Allow runs without asking. Ask puts an approval card in the chat, and the tool waits for you. Deny blocks it. Rules can differ by mode and subagent type, so a reviewer can read but never write, and nothing runs a shell in plan mode.

  • Set rules in Settings ▸ Agents ▸ Permissions
  • Approval cards show exactly what will run before it runs
  • Hooks in .dune/hooks.json can inspect calls before and after each tool
Permissions guide
chat — approval
dune wants to run a shell command
$ pnpm add zod
rule: run_shell → ask (agent mode)
[ allow once ] [ always allow ] [ deny ]
04 / 06

Type @ to attach live IDE state: the semantic codebase index, your git changes, the problems panel, symbols, files or the web. Slash commands give common tasks a head start, and you can write your own as Markdown.

  • @Codebase, @Git, @Problems, @Symbols, @Web, and any file
  • Slash commands: /fix, /test, /docs, /code-review, /review-security, /automate and more
  • Custom commands in .dune/commands/*.md
chat — composer
@Codebase @Git /fix
why does the seat stepper clamp to 1 while I type?
attached: 6 code chunks · 2 changed files · 1 diagnostic
05 / 06

The agent checkpoints the workspace as it edits. Restore any earlier point in the conversation and the files go back with it, including files the agent created. Review the diff in the Git panel, keep what you like, and commit.

chat — checkpoints
● checkpoint 3 · 4 files changed (+38 −6)
● checkpoint 2 · 1 file created
● checkpoint 1 · conversation start
restore to checkpoint 2? [ restore ]
06 / 06

Skills are playbooks the agent follows, written as SKILL.md files you can read and edit. Memory persists across sessions and is recalled by search. While the app is idle, Dreaming runs passes that consolidate memory, refresh the code index, review past sessions and propose new skills. Every cycle can be undone.

  • Skills in .dune/skills/<name>/SKILL.md, distilled from your sessions or written by hand
  • Rules in .dune/rules/ (always on, or scoped by glob) and a project constitution
  • Dreaming passes: memory, code index, project refresh, reflection, session digest, skill hygiene, trajectory mining
dreaming — last cycle
✔ memory merged 4 duplicates
✔ code index reindexed 37 changed files
✔ skill hygiene proposed: release-checklist
staged for review · undo cycle

FilesCORE

read_file, write_file, edit_file and list_files across the workspace, local or remote.

ShellCORE

run_shell in a real terminal, plus await_job for long-running commands.

SearchCORE

search_code for exact matches and a semantic code index with reranking for meaning.

Packages

install_packages picks the project's package manager and installs what a task needs.

Web

web_search through Brave, DuckDuckGo, Exa or Tavily, chosen in Settings ▸ Agents.

Browser

open_browser and browser_control to load a page, click through it and read the result.

MCP

Any stdio MCP server from .dune/mcp.json, with its tools dropped straight into the loop.

Tunnels

Start and list tunnels to share a local dev server while the agent works.

Todos & asks

manage_todos keeps the plan current; ask_user stops to ask you a question.

PathWhat it does
.dune/rules/Always-on or glob-scoped instructions
.dune/constitution.mdProject-wide principles the agent follows
.dune/skills/<name>/SKILL.mdPlaybooks the agent can load
.dune/commands/*.mdCustom slash commands
.dune/modes/*.mdCustom agent modes
.dune/agents/Named subagents
.dune/hooks.jsonHooks that run before and after tool calls
.dune/mcp.jsonMCP servers (stdio)
.dune/plans/Saved plan documents

Models come through your Hypery account. You choose separate models for chat, inline completion and Cmd+K edits in Settings ▸ Agents ▸ Models. Usage is counted in AI credits.

A warm, AI-first workbench. Free to download. Bring your extensions, your themes, and your agent.

Read the docs >