Developer docs

Hassle is a local-first CLI. Run it yourself or hand it to your agent — Claude, Codex, Gemini or xAI. Everything that touches your code runs on your machine; Hassle stores only derived, signed evidence.

Install & login

Install the CLI and bind your workspace with a device code. Login happens where your company is built so Hassle can attach to your local scanner.

founder@hassle — zsh

$ curl -fsSL hassle.dev/install | sh
$ hassle login --device
  visit hassle.dev/device · code HX-92KQ
  ✓ workspace bound · evidence room ready

This command requires an approved beta account.

Scan & route

A scan runs deterministically and locally, then optionally generates a model summary. Verified claims never depend on the model.

hassle scan

$ hassle scan
  → Running deterministic local scan
  ✓ framework detection
  ✓ dependency graph
  ✓ API route analysis
  ✓ secret scan
  ✓ test maturity
  ✓ CI/CD detection

  Model summary:
  Using Hassle managed model gateway

  Run hassle model configure to use your provider or local/private mode.

Model modes

Hassle separates proof from narrative. The scanner produces deterministic, source-backed findings. A model then summarises and explains them. You choose which model does the summarising — it never changes verification status.

Default

Hassle managed

Easiest setup. Use Hassle's governed model gateway for scan summaries and readiness coaching.

no config required

BYOK

Founder / Enterprise BYOK

Use your own approved provider credentials for summaries. Funds and firms isolate credentials per organisation.

your API key stays yours

Advanced

Local / private

Run a local model for private summaries. Labelled separately from verified claims and cannot verify them.

advanced · founder-side

A fifth mode — no-model deterministic scan — skips summarisation entirely and emits only structured findings.

Local model summaries cannot independently verify claims. They are used to explain structured findings created by the scanner. Verification always comes from deterministic scans, connectors and signed evidence.

Preview exactly what is sent

The most important command for trust. Inspect the model payload before any call is made.

hassle scan --preview-model-context

The model will receive:
✓ structured architecture findings
✓ dependency summary
✓ test maturity summary
✓ security finding categories

The model will not receive:
✗ raw source files
✗ .env files
✗ secrets
✗ customer data
✗ raw logs

Model commands

hassle model statusShow the active model mode and payload policy.

hassle model configure anthropicUse Anthropic as your approved provider.

hassle model configure openaiUse OpenAI as your approved provider.

hassle model configure local --provider ollama --model llama3.1Use a private local model for founder-side summaries.

hassle model testVerify the configured model can be reached.

hassle scan --preview-model-contextShow the exact payload before any model call.

hassle scan --no-modelDeterministic scan only — no summarisation.

hassle scan --model localRun the scan summary through your local model.

Local / private mode

Advanced founders can configure local models for private summarisation. Hassle still relies on deterministic scanner output, source-backed claims, schema validation and signed evidence reports. Local model summaries are labelled separately from verified claims.

founder BYOK · local

$ hassle model configure local --provider ollama --model llama3.1
  ✓ local model configured

$ hassle scan --model local
  Model summary:
  Using local model: Ollama llama3.1
  Payload: structured findings only
  Raw code sent: no
  Note: local model summaries are labelled separately from verified claims.

Post-raise: operate

When the round closes, the operating commands prepare board-ready truth from connected runway, GTM and product proof. The CLI prepares operating truth; the dashboard publishes it.

hassle operate statusRunway, burn, board-update countdown and open actions.

hassle runway syncPull cash, burn and revenue from connected finance systems.

hassle runway set-cash 412000 --currency GBPEnter cash manually (labelled self-reported).

hassle runway forecast --burn 29000Model hiring / spend impact on runway.

hassle gtm syncImport pipeline, meetings and conversion from your CRM.

hassle gtm summary --month 2026-06Draft a board-ready GTM summary with suggested asks.

Post-raise: board & meetings

hassle board draft --month 2026-06Draft a board note from operating proof. Private until published.

hassle board publish board_123 --to boardPublish to selected recipients — confirms before sending.

hassle board pack generate --month 2026-06 --format pdfAssemble a board pack with evidence labels.

hassle meeting import transcript.txt --type boardImport a transcript (founder-only by default).

hassle meeting summarise meeting_123Extract decisions, actions and investor asks for review.

Post-raise: actions, updates & follow-on

hassle actions listOpen, overdue and investor-owned actions.

hassle actions create "Intro to buyer" --owner northwall --due 2026-06-14Create an action with an owner and due date.

hassle update draft --monthlyDraft a monthly investor update from this month's proof.

hassle followon readinessHonest readiness for the next round — gaps and timing.

Drafts are private and risky publishes are confirmed. Board notes, investor updates and meeting transcripts stay private until you explicitly publish. Publishing to investors requires a typed PUBLISH confirmation, and every publish or export is logged.