# 10 — Cheatsheet (the commands you'll actually type)

## The two paths you use

**CLI** (long form, works everywhere):
```
NODE=/home/mike/.local/node24/bin/node
CLI=/home/mike/.paperclip/cli/current/node_modules/paperclipai/dist/index.js
```

**Helper scripts** (shortcuts, inside this project):
```
cd /mnt/datapool/hermes_workspace/projects/paperclip-learning
./scripts/status.sh                 # snapshot: company, agents, issues, approvals
./scripts/learnquiz.py              # quiz the vocabulary
./scripts/practice-run.sh           # safe logged practice run
```

## Read-only — safe anytime

```
./scripts/status.sh                 # everything at a glance
$NODE $CLI doctor                   # check install health
$NODE $CLI company current          # what am I in?
$NODE $CLI company list             # all companies
$NODE $CLI agent list               # employees
$NODE $CLI agent get <id>           # one employee's details
$NODE $CLI issue list               # work orders
$NODE $CLI approval list            # pending sign-offs
$NODE $CLI activity                 # recent activity
$NODE $CLI dashboard                # one-screen summary
$NODE $CLI cost                     # spending
```

## Changing something — always read `--help` first

```
$NODE $CLI issue create --help          # file a work order
$NODE $CLI agent hire --help            # hire an employee
$NODE $CLI agent pause <id>             # safely stop an employee
$NODE $CLI approval approve <id>        # sign off
$NODE $CLI company create --help        # start a fresh company
$NODE $CLI company export <id>          # back up a company to a file
```

## House rules (lab safety)

1. Prefer read-only. `--help` before anything that changes state.
2. Label experimental things `TEST:`.
3. Pause instead of delete when unsure.
4. This learning project doesn't rebuild `ndyinc`/the Wind Sculpture Agent —
   those belong to `multi-agent-workgroup`.
5. Ask "what does this change, and how do I undo it?" before running.
6. Log what you learn in `docs/log.md`.

## Where the docs live

- This project's lessons: `docs/01`–`docs/09` (plain English, for Mike).
- Official Paperclip docs: `docs.paperclip.ing`
- Hermes-as-employee: `docs.paperclip.ing/reference/adapters/hermes/`
- FAQ of concept words: `docs/02-vocabulary.md`.
