hobhob
Get Started

Install

This guide gets you from install to your first useful agent session in hob.

This guide gets you from install to your first useful agent session in hob. You'll open a project, launch an agent, tile a terminal alongside, and review the result.

Get access to hob

hob is currently in private alpha. Drop your email and we'll let you know when access opens up.

You also need an agent CLI

hob is the surface — you bring your own agent. Install at least one CLI and make sure it's in your PATH:

  • Claude Code (recommended) — npm install -g @anthropic-ai/claude-code
  • Codex CLI
  • OpenCode
  • Gemini CLI

Ask an agent to explain your codebase

After you pick a folder, press Alt+A to open an agent pane. Ask it to orient you in the project.

Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.

The agent will search your repo, read relevant files, and summarize how the project fits together. This is one of the fastest ways to get oriented in an unfamiliar codebase.

Make one small change

Once you understand the project, ask the agent to suggest a few safe improvements. Pick one and ask it to make the change.

Suggest three small, safe improvements in this codebase. Explain the tradeoffs and wait for me to choose one.

Good first tasks are low risk — improving some copywriting, fixing a small UI issue, or adding a missing type annotation.

If you already know what you want to change, ask for it directly and describe the result you want.

By default, the agent asks for permission before editing files. You can switch to Approve All mode in the pane header for faster iteration.

Tile a terminal and verify

Press Alt+T to open a terminal next to your agent — both panes tile side by side, no switching tabs. Run whatever checks your project already uses.

npm test

When the agent finishes, review the diff and ask it to run the checks your project already uses. That can mean tests, the type checker, linting, or a local build.

Set up agent instructions

Create an AGENTS.md file in your project root to give every agent persistent context about your project:

AGENTS.md
# Project Guidelines

- This is a Next.js 14 app with TypeScript
- Use the App Router, not Pages Router
- Run tests with `npm test`
- Follow the existing code style

Auto-sync

hob automatically syncs AGENTS.md with CLAUDE.md so all agent CLIs read the same instructions.

Next steps

How is this guide?

On this page