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 failing test, runs it, fixes the code, and reruns until it passes, quoting the real output it got. Checking its own work is a habit built into the agent, not a chat trick. See prove it, don't promise it for why.