Skip to content

CLI

Drive Hydron from your terminal with keyboard-first navigation.

Same engine as the VS Code extension. Hardware-aware workflows, including serial monitoring and peripheral context, follow you to the command line.

Get started

cd /path/to/firmware/project
hydron

On first launch, click Login when prompted. See Quickstart for the full sign-in flow.

Once authenticated and your project is set up:

  1. Press Ctrl+Shift+P to open the command palette and select your project.
  2. Type your first hardware-aware prompt.
  3. Press Tab to cycle agent modes: Ask, Plan, Debug, Code.

Top-level commands

Run from your shell.

Command Description
hydron [project] Start Hydron in the given project path, defaulting to the current directory
hydron run [message] One-shot run: send a message and exit when done
hydron pr <number> Check out a GitHub PR and start Hydron in it
hydron auth Manage credentials: login, logout, list accounts
hydron session Manage saved sessions
hydron stats Token usage and cost summary
hydron upgrade [target] Update to the latest release
hydron help [command] Detailed reference for any command

Tip

Run hydron help to see this list in your terminal.

Keyboard shortcuts

Run /help to see these in Hydron.

Chat input

Shortcut Action
Shift+Enter New line
Up / Down Prompt history
Ctrl+C Clear input

Drive the agent

Shortcut Action
Esc Interrupt the current turn
Tab / Shift+Tab Cycle agent modes
Ctrl+Shift+P Open command palette

Tip

Use Esc to stop Hydron mid-turn. Context is preserved, so you can immediately course-correct.

Sessions and projects

Press Ctrl+X then:

Key Action
n New session
l List and switch sessions
p Switch project
c Compact session
e Open external editor
q Exit Hydron

Hardware

/serial runs inside a session. Use /sessions to select or resume one, then connect with /serial. See Serial monitor.

Next