CLI¶

Drive Hydron from your terminal with keyboard-first navigation.

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

Installation¶

macOS / LinuxWindows

curl -fsSL https://get.hydron.sh/cli/install.sh | bash

irm https://get.hydron.sh/cli/install.sh | iex

Info

The CLI auto-updates in the background to keep device support current.

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 Dashboard is set up:

Press Ctrl+Shift+P to open the command palette and select your Hydron project.
Type your first hardware-aware prompt.
Press Tab to cycle agent modes: Ask (explanations), Plan (design), Debug (bugs), Code (direct changes).

For the full slash commands reference, see Slash Commands.

Top-Level Commands¶

Run from your shell.

Command	Description
`hydron [project]`	Start Hydron in the given project path (defaults to 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 Hydron release
`hydron help [command]`	Detailed reference for any command

Tip

Run hydron help to see this list in your terminal.

Hardware¶

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

`/serial`¶

Ditch minicom and screen. Open a persistent, interactive serial monitor directly inside your chat session.

Inside the panel (mouse-driven):

Connect, disconnect, or reconnect to a port
Pick a port from the detected list
Add or remove a saved port
Cycle baud rate
Clear the buffer
Filter input
Send input to the connected device

Screenshot coming soon.

Keyboard Shortcuts¶

Tip

Run /help to see this list in Hydron.

Troubleshooting¶

Windows: If Windows Defender blocks the installer or quarantines the binary, see Windows Troubleshooting for step-by-step instructions to add an exclusion or bypass SmartScreen.

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 (Ask, Plan, Debug, Code)
`Ctrl+Shift+P`	Open command palette

Tip

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

Sessions & projects¶

Press Ctrl+X then:

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