# Setup guide — Task Capture & Organization Agent

## 1. Install and connect

Install the agent and connect your task app (optional).

```
pipx install task-capture-agent
task-capture-agent connect --app todoist
task-capture-agent doctor
```

## 2. Configure guardrails

No invented tasks and no autonomous action are enforced here.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
NO_INVENTED_TASKS=true
LABEL_INFERRED=true
AUTO_ACTIONS=false   # proposes; never schedules/sends without confirm
```

## 3. Set preferences

Define your projects and priority cues.

```
# tasks.yml
projects: [work, personal, errands]
priority_cues: { urgent_words: [asap, today, urgent] }
```

## 4. Capture a brain-dump

Organize input and review flags before anything is added.

```
task-capture-agent run --input ./braindump.txt --explain
# prints organized tasks + needs_clarification + proposed_actions (nothing done yet)
```

## 5. Wire into your app

On confirmation, add the organized tasks to your tool.

```
# brain-dump -> organized proposal -> you confirm -> tasks added
```
