Install the CLI, run Polygraph, and start your first session.
Install
Section titled “Install”npm install -g polygraph@latestRun the CLI
Section titled “Run the CLI”Start with the interactive CLI. It guides you through sign-in, account selection, and session setup.
polygraphCheck your account
Section titled “Check your account”After sign-in, confirm the effective account before starting a session.
polygraph whoamiSign in manually
Section titled “Sign in manually”If you want to run the sign-in flow directly, use the auth command.
polygraph auth loginStart a session
Section titled “Start a session”A session coordinates work across one or more repos.
polygraph session startThe session comes with an ID and an URL. For example, foo-bar-00ff00ff and https://app.trypolygraph.com/orgs/<org-id>/sessions/foo-bar-00ff00ff. You can use the ID to resume a session, and the URL to inspect the session.
Attach more repos
Section titled “Attach more repos”Inside a session, you can prompt the agent to add additional repos to the session.
For example,
Please add vitejs/vite repo to this session.You can add any public repos or repos that you own to the session.
Alternatively, use the CLI to add a repo to an active session.
polygraph session add-repo vitejs/vite --session <session-id>List and inspect sessions
Section titled “List and inspect sessions”polygraph session listShow details such as URL, folder, and status for a session.
polygraph session show <session-id>What next
Section titled “What next”Pick a workflow that matches what you want to do.