---
url: /build/cli.md
description: Install the dutygraph CLI, sign in, and run your first commands.
---

# 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

::: tip 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.

::: warning 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](../playbooks/index.md). Open the folder in Claude Code and ask for the morning check.

## Next

* [Every command](../reference/cli-commands.md)
* [Playbooks](../playbooks/index.md)
