Reference

Command line

Run pointfix commands inside your app’s repository. Configuration is discovered upward from the current folder.

pointfix <command> [--flag=value …]

Commands
Command	What it does
`init`	Set up Pointfix in this project (writes `pointfix.config.json`).
`doctor`	Check Node, configuration, agents, subscriptions and platform tools.
`start`	Start the bridge for this project.
`status`	Show whether this project’s bridge is running, and its queue.
`open`	Open the dashboard in your browser.
`config`	Show the resolved configuration and settings.
`help`, `--help`, `-h`	Show help. Running `pointfix` alone does the same.
`--version`, `-v`	Print the version.

Flag syntax

Write values with an equals sign: --port=4848. A space-separated value (--port 4848) is not read as the flag’s value.

An unknown command prints the help and exits with status 2. A failing command prints pointfix <command>: <message> and exits with status 1. POINTFIX_CONFIG, POINTFIX_PROJECT and POINTFIX_PORT override the configuration for every command; see Environment variables.

init

pointfix init [--agent=ID] [--port=4747] [--origin=http://localhost:5173] [--yes] [--project=PATH]

init flags
Flag	Effect
`--agent=ID`	The default agent: `claude`, `codex`, `cursor`, `gemini`, `copilot`, `opencode`, `droid`, `qwen`, `amp`, `goose`, `aider` or `custom`. Otherwise the existing `defaultAgent`, else the first supported agent on your `PATH`, else `codex`.
`--port=N`	The bridge port, 1024–65535. Otherwise the existing port, else 4747.
`--origin=URL`	Adds a web dev origin to `allowedOrigins`.
`--yes`	Don’t ask questions. Without it, an interactive terminal is asked for the agent and port.
`--project=PATH`	Set up this folder instead of the detected project root. Not shown in `help`.

init keeps existing settings in pointfix.config.json, sets project to "." if missing and autoDispatch to true if missing, merges detected dev origins, adds .pointfix/ to .gitignore, and prints the SDK snippet for each detected platform (web if none). See Set up a repository.

doctor

pointfix doctor

Checks, in order:

Node.js is version 20 or newer.
The configuration loads, and pointfix.config.json exists (a warning suggests init if not).
The project is a Git repository (a warning if not).
A Pointfix bridge for this project is running on the port, or the port is free. A bridge for another project, or another program on the port, is a problem.
The selected agent (from Preferences, else defaultAgent) is installed.
Claude Code and Codex are installed and signed in with a subscription. This is a problem for the selected agent unless useApiKeys is on, otherwise a warning.
xcodebuild for iOS projects and adb for Android projects (warnings).

It ends with Everything looks ready. or the number of problems, and exits with status 1 if there are any.

start

pointfix start [--port=N]

Starts the bridge in the foreground and prints its URL and project. With "remote": true, it also prints the URLs other Macs can use. Ctrl + C stops it; an active run is stopped and marked interrupted. --port overrides the configured port for this run.

status

$ pointfix status
Pointfix 0.2.0 running at http://127.0.0.1:4747
Project  /Users/you/your-app
Agent    claude (sonnet)
Auto     mode on · relaunch off · commit off
Reports  12 total · 1 working · 2 to review · 0 need attention

“Working” counts queued, fixing, checking and rebuilding reports; “need attention” counts failed, interrupted and stopped ones. Exits with status 1 if this project’s bridge isn’t running, or if the port serves another project.

open

pointfix open

Opens http://127.0.0.1:<port>/ in your default browser and prints the URL. Exits with status 1 if this project’s bridge isn’t running.

config

pointfix config

Prints the configuration file in use (or none; using defaults), the resolved configuration as JSON, and the saved Preferences from .pointfix/settings.json.