Skip to Content
Custom Agents

Custom Agents

Add any CLI tool from the Add Tool menu, click +, choose Add Custom Command, type the command, press Enter. If it runs in a terminal, it runs in Pane.

Pane is agent-agnostic. Any CLI tool you can run in a terminal, you can run as a custom command.

Terminal
$ your-agent --flag
Agent started...
Reading project files...
✓ Task complete
$

Add a Custom Command

  1. Click the + in the tab bar to open Add Tool.
  2. Choose Add Custom Command….
  3. Type any command, like aider, gh copilot, or npm run dev.
  4. Press Enter. Pane saves the command and launches it right away.

Pane names the tab from the first few words of your command. The first four custom commands you add each get a hotkey, ++6 through ++9 on macOS, Ctrl+Alt+6 through Ctrl+Alt+9 on Windows and Linux. Click the X next to a saved command to delete it.

Commands run exactly as typed, in a real terminal, inside the pane’s worktree. There’s no prompt template or placeholder to fill in, because none exists. If your command contains claude, codex, or cursor-agent, Pane adds session-resume handling automatically. Everything else just runs, verbatim.

Any CLI Works

Pane doesn’t keep an allowlist of agents. GitHub Copilot CLI, Goose, OpenCode, your own build script: add any of them as a custom command, the same way as Claude Code or Codex.

On a Windows machine with a WSL project, Pane detects \\wsl$\ paths automatically and runs your custom command inside that WSL distro. Install the CLI there first. Run runpane agents doctor --agent codex (or --agent claude) to check that Claude Code or Codex is reachable. For any other CLI, just try the command. If Pane can’t find it, add its folder in Settings → Advanced → Additional PATH. See Troubleshooting for more on PATH issues.

Automating From the CLI

Agents and scripts can create panes with a custom command directly:

runpane panes create --tool-command '<cmd>'

For multi-step setups, wrap them in a shell:

runpane panes create --tool-command bash -lc 'npm install && npm run dev'

See the runpane CLI for the rest of the command set.

Is There a Plugin API?

No. Pane doesn’t have a plugin or extension system today. What you get instead: custom commands (this page), terminal shortcuts, the runpane CLI, and project scripts in pane.json.

Pane is AGPL-3.0 open source, so you can fork it and build deeper integrations yourself. See the Troubleshooting & FAQ page for what that license requires. File extension requests at github.com/dcouple/Pane/issues .

Custom Shortcuts

Custom Shortcuts are a different feature: a keyboard shortcut that pastes a saved command into the terminal without running it automatically. See Keyboard Shortcuts for setup steps.

Last updated on