Skip to content
DocsCommand reference

Command line

Command reference

Every gr command, by what it is for. Each page lists a command's subcommands and flags.

From the help of gr 0.2.16.

These are the commands most people use. On your own machine, gr help lists every command andgr help <command> shows one command's help in full. The commands not here are for Graphide's own development or still settling, and may change without notice.

Set up

gr loginLog in to Graphide
gr logoutLog out of Graphide
gr appThe Graphide app: whether a newer one is out, updating it, and going back
gr versionPrint this build, the daemon's, and whether a newer one exists
gr termsRead, and accept, changes to Graphide's terms and privacy policy
gr telemetryShow or change what this install reports
gr uninstallRemove Graphide's settings, sign-in and cached data from this computer
gr completionGenerate the autocompletion script for the specified shell

Build and keep the map

gr projectStart a project on this machine
gr initInitialize and build the project graph
gr syncBring the graph back in step with the code
gr mapShow whether main's map and every worktree's are up to date
gr statusReport whether the daemon is serving this project
gr stopClose this project's workspace in the daemon, if it is open
gr worktreeCreate, list and land git worktrees that have a graph in them
gr trustShow or change whether Graphide may run this project's own code
gr clearDelete the entire graph for this project
gr forgetDelete this machine's record of what you have been looking at

Ask the map

gr summaryPrint the graph's architecture, hubs, entry points and questions
gr queryAsk the graph a question (search + typed walk, budgeted)
gr impactList callers and users of a node, hop by hop
gr codePrint a node's source code
gr outlineList a file's symbols with spans and signatures
gr similarFind similar code using local embeddings
gr recapPrint what a finished turn or build did

Coding agents

gr claudeRun Claude Code with Graphide injected at launch; writes nothing to your files
gr codexRun Codex with Graphide's MCP server injected at launch; writes nothing to your files
gr harnessWrite a terminal agent's integration to disk (or run gr claude to write nothing)
gr mcpServe this workspace's graph to an external agent harness over MCP (stdio)
gr agentList, start, read, type into and stop this workspace's agents

Cloud and teams

gr cloudYour cloud projects, and building a local graph from one
gr githubConnect GitHub and add cloud projects
gr orgYour orgs, their people, invites and projects
gr machineManage the computers on your account

Plugins

gr pluginWrite, check, install and manage Graphide plugins

When something is wrong

gr doctorReport what is wrong with this project, and fix what can be fixed
gr reportBundle logs and status for a bug report
gr logsShow this machine's Graphide events
gr daemonInspect and control the machine-wide daemon

These docs describe Graphide 0.2.16, the latest release. Something wrong or missing? Tell us onDiscord or at hello@graphide.com.