Session: keys and commands

You've installed codehamr. Here's the quick tour.

Configure HamrPass

If you bought a HamrPass, you got an hp_... key by email. Two ways to wire it up.

Inside a session (fastest):

Start codehamr.
```
codehamr
```
Type /hamrpass, paste your key, press Enter.
Type /models hamrpass, press Enter.

You're on HamrPass. The budget bar appears in the status line.

Or edit your config file:

.codehamr/config.yaml

active: hamrpass

models:
    hamrpass:
        llm: hamrpass
        url: https://codehamr.com
        key: hp_xxxxxxxxxxxxx

Running local Ollama instead? Skip this section. See the Ollama guide.

The three slash commands

That's the whole command surface.

Command	What it does
`/models`	List your profiles. Add `<name>` to switch. Tab cycles options in the popover.
`/hamrpass`	Set or show your HamrPass key.
`/clear`	Reset the conversation and clear scrollback.

Tab on an empty prompt seeds a / so you can browse commands.

Keys you'll use

Key	What it does
Enter	Send your prompt
Alt+Enter	Insert a newline
Up / Down	Walk your command history
Ctrl+L	Clear the typed prompt, redraw the screen
Ctrl+C	Cancel the current request. Press again within 3 seconds to quit.
Ctrl+D	Quit (only on an empty prompt)
Esc	Close a popover, or back out of an argument

Your first task

Pick something small and checkable:

"Add a failing test that proves parse_url('http://x:') rejects URLs with an empty port. Then make it pass."

Press Enter. Codehamr writes the test, runs it, fixes the code, and only claims done when it has a passing check to quote. That's not a chat trick, it's built into the agent. See Get Your Shit Done for why.