Reference

Intentflow docs

Install, pick a range, review, export.

1. Start

Run it in the repo you want to review. It opens the browser.

One static binary; assets and checksums: releases

shell
cd /path/to/your/repo
intentflow --base main
intentflow --no-open --base main

2. Pick a range

Common ranges

Common ranges
Command Meaning
intentflow --base mainmain to HEAD
intentflow --base main --head WORKTREEmain to the worktree, with untracked files
intentflow --base v1.0 --head HEADtag or commit range
intentflow --before ./a --after ./btwo directories, no Git

Flags

Flags
Flag Meaning
-t, --targetrepo directory, default `.`
--basebaseline; nearest of main, master, origin/main, origin/master
--headend point, default `HEAD`; `WORKTREE` adds uncommitted files
--before, --aftertwo directories instead of a Git range
--hostlisten address, default `0.0.0.0`
--portport; `0` picks a free one
--outwhere `intentflow diff` writes `review.json`
--distoverride the embedded frontend, debug only
--no-opendo not open the browser
-vprint progress

With no `--base` it takes the nearest ancestor and never falls back to `HEAD~1`.

3. Review

Comments and marks belong to this comparison, in the browser.

The review panel: one composer at the top, two comments below it.
Review panel
  • Comment a line, or drag a range.
  • `Ctrl`+`F` searches every file, with case and whole-word switches.
  • A rename is one card: old path, arrow, new name.

Viewed marks

Keyed by file, row and content digest, so an edited hunk loses its mark.

  • Marking a file marks its hunks.
  • A viewed file greys out and collapses.

4. Symbols

Click an identifier to list every place it appears.

Scope: changed files of this comparison, both sides. No index, no language server.

The symbol panel listing every reference of $hit, grouped by file with line numbers.
Reference list

How to use it

  1. Click a word to open the panel.
  2. Click a row to jump to that line.
  3. Whole word by default: `hit` does not match `hits`.

`$hit` returned 1457 rows in one comparison.

5. Export

Two rows: copy to the clipboard or save a file.

  • Markdown: path, side, line, quoted code.
  • JSON: the full document.
  • `Ctrl`+`Enter` copies Markdown without the menu.
review.md
# Review: main → HEAD

## Review 意见

### 1. internal/store/store.go:15 · 改动后

> query = fmt.Sprintf("... WHERE name LIKE '%s%'", name)

改成参数化查询。

### 2. 整体意见
这次改动建议整体退回。

6. For agents

The repo ships a skill at skills/intentflow/SKILL.md.

  • Say “review my changes with intentflow”. The agent runs the command and gives you the URL.
  • You still write the comments; the agent reads the Markdown you paste back.

7. Where reviews live

  • Reviews: `localStorage`, key `intentflow.review.<comparison_id>`.
  • Images: inline data URLs, up to 1.5MB each.
  • Layout preferences: the same store, `intentflow.` prefix.
  • The server writes no files.

8. Build

Go 1.24+, pnpm and git. `schema/openapi.yaml` generates both sides.

make
make tools          # oapi-codegen and frontend deps, once
make schema         # schema/openapi.yaml -> Go and TypeScript types
make check          # go vet, Go tests, tsc, Vitest
make build          # frontend build and static binary
make release-check  # cross-compile the six release targets

No binary yet? Run `./scripts/build.sh`. Site: `make site`, port 8131.

9. Design documents