# 04 — Companies and agents

This is the heart of Paperclip: a **company** is the "team", and **agents** are
the "employees". Let's make these concrete with your real company.

## Your company: ndyinc

Your 3050 is already running a Paperclip company named **ndyinc**. The **board
admin is Mike** — that's you. From the dashboard you see everything: agents,
budget, activity, approvals.

View it:

```
cd /mnt/datapool/hermes_workspace/projects/paperclip-learning
./scripts/status.sh
```

Look at the `company` section — name, id, and how many agents.

## Agents = employees

An **agent** is one AI employee. It has:

- a **name** and role,
- a **runtime** (which AI engine it uses),
- a **model** (which model),
- **permissions** (what it may do),
- a **budget** (how much it may spend),
- a **heartbeat** (how it checks in for work).

List your current employees:

```
./scripts/status.sh agents
```

You should see the agent hired by your `multi-agent-workgroup` project. That
work is still yours — but **this** project is about understanding how each piece
fits, so read on.

## How an agent gets work

1. Someone creates an **issue** ("a specific task").
2. The issue is **assigned** to an agent.
3. On the next **heartbeat**, the agent picks it up, works, and reports back.
4. Its work may need an **approval** before it counts as done.

The point: **you don't tell the AI to "just do it." You create work, assign it,
and the system tracks, approves, and bills it.** That's what turns one agent into
an organization.

## The key mental model

```
COMPANY  = the whole workshop        (ndyinc)
│
├── AGENT    = one worker            (e.g. Wind Sculpture Agent)
├── ISSUE    = a work order          (assigned to an agent)
├── APPROVAL = the boss signs off    (you)
└── BUDGET   = what each worker may spend
```

## Try it (safe)

View, don't change:

```
./scripts/status.sh companies
./scripts/status.sh agents
```

If you can read `company current` and `agent list` and understand what you're
looking at, you've got lesson 4. Move to `docs/05-tickets-work-and-approvals.md`.
