Skip to content

CLI ​

This page is for: advisors, forward-deployed engineers and developers who connect AI tools or the CLI.

The dutygraph CLI lets an advisor or FDE work on a client's map from a terminal, side by side with Claude Code. It talks to the same MCP endpoint as your AI assistant, with your own access.

Install ​

Built

On npm

The package is dutygraph, version 0.2.1.

sh
npm install -g dutygraph     # or run any command with: npx dutygraph
dutygraph --version

It needs Node 20 or later.

Sign in ​

Built

sh
dutygraph login              # opens the browser: read and write
dutygraph whoami
dutygraph logout

Browser sign-in cannot send email. To send, use a Settings token that has the Send email scope:

sh
dutygraph login --token dgp_...
# or
export DUTYGRAPH_TOKEN=dgp_...

Which DutyGraph it talks to ​

The CLI talks to https://dutygraph.com unless you say otherwise. To use another deployment, such as a preview or your own firm's address, add --origin to each command, starting with login:

sh
dutygraph --origin https://your-dutygraph-address login
dutygraph --origin https://your-dutygraph-address companies

The default company you pick with use is saved for each address on its own.

Newer commands need the newest server

client add, pitch and onboarding work only where the server has them. If a command answers that the tool is not found, the address you are using runs an older version. Ask the DutyGraph team which address to use.

First commands ​

sh
dutygraph companies
dutygraph use "Northstar Parts"
dutygraph team
dutygraph repo pull ./northstar-repo

use picks the company later commands work on. --company <name or id> overrides it for one command.

How commands behave ​

  • Preview first. A command that changes data shows what it will do and asks, unless you pass --yes.
  • No email by default. Email needs --send, a confirmation, and a token with the Send email scope.
  • No stale writes. A change uses the version it just read. If someone else changed the record, the command stops.
  • Safe to retry. Repeating the same import or push does not create duplicates.

Work with Claude Code ​

repo pull writes AGENTS.md, CLAUDE.md and a skill pack into the folder, so Claude Code knows the rules of the Repo and the playbooks. Open the folder in Claude Code and ask for the morning check.

Next ​

DutyGraph. Pages label each feature Built, In review or Planned.