Docs

Installation

To get started with Habitat,

• Install the CLI

  // Coming soon

• Once installed, setup Habitat with

  ht setup

This command will launch an interactive CLI experience. This will

1. Log you in to your Habitat workspace
   1. If you’re already logged in to a workspace, you can choose to add another workspace, and then setup will be for that workspace.
2. Automatically detect your Claude/Codex projects and allow you to select which projects to ingest
3. Allow you to select how far back to backfill historical sessions
4. Confirm and begin ingestion. This will
   1. Backfill historical sessions
   2. Configure Claude/Codex hooks that will be called during sessions to ingest sessions in realtime as you work

If you need to restart the setup process due to any issues, it is safe to repeatedly run ht setup

If you want to modify your setup later, you can run

ht configure

If you want to inspect the ingestion pipeline, you can run

ht status

If you want to uninstall Habitat, you can run

ht uninstall

User Interfaces

MCP

Habitat is available to install as an MCP. Habitat provides the following tools to your agent

get_sessions(by_authors, from, to)
get_session(id)

You can then do everything you can do in Habitat web directly in your favorite agent.

Web App

Habitat is available as a web app.

Home

You can read a summary on what you and your team are working on.

Sessions List

You can read your teammates sessions.

Analytics

• Token cost
• Timing
• Tool calls

Habitat Agent

You can ask the built-in Habitat agent questions about any of the above pages.