# Monte Overview

Monte is context personalization for AI agents.

The main runtime command is:

```bash
monte personalize context "TASK HERE" --json
```

It returns a compact, task-specific agent patch from persona evidence. Agents should apply `instructionBlock`, `personalizedMoves`, `executionProtocol`, `taskAntiPatterns`, and `truthSafety` before doing the work.

## Install

```bash
npm i -g monte-engine
pnpm add -g monte-engine
yarn global add monte-engine
bun add -g monte-engine
```

## Fast path

```bash
monte setup
monte personalize context "Help me decide what to focus on today without fake progress." --json
```

## Context modes

Use `--mode` when the task type is obvious:

- `general`: normal personalized help.
- `planning`: plans, sequencing, projects, events, constraints, and follow-through.
- `writing`: drafts, tone, messaging, content shape, and audience fit.
- `decision`: tradeoffs, recommendations, option scoring, and next moves.
- `learning`: explanations, teaching style, practice paths, and comprehension.
- `research`: source gathering, evidence synthesis, vendor scans, and comparisons.
- `creative`: naming, concepts, campaigns, stories, and divergent options.
- `coding` and `design`: explicit preview modes; not auto-selected from broad keywords.

Examples:

```bash
monte personalize context "Help me approach this task" --mode general --json
monte personalize context "Plan next week" --mode planning --json
monte personalize context "Draft this update" --mode writing --json
monte personalize context "Pick the best option" --mode decision --json
monte personalize context "Teach me this topic" --mode learning --json
monte personalize context "Research vendor tradeoffs" --mode research --json
monte personalize context "Name this product" --mode creative --json
```

## Sources matter

Monte gets useful when it has evidence of how you actually decide, write, prioritize, recover from friction, and work with agents. High-signal sources include chat exports, AI conversations, Obsidian vaults, Notion workspaces, notes, decision logs, project docs, writing samples, task plans, retrospectives, and feedback.

Use the guided setup wizard with a folder or export file:

```bash
monte setup --files <path> --yes
```

Avoid uploading passwords, API keys, payment details, raw secrets, or files that do not describe how you think or work.

## Profile export is not runtime

`monte personalize profile --json` is an inspect/export snapshot, not the main agent runtime. It can be saved locally, but it goes stale, is not task-scoped, lacks live calibration and usage controls, and should not replace fresh `monte personalize context` calls for important work.

Use `profile --json` for debugging, inspection, export, or verifying that a persona exists. Use `context` when an agent is about to do real work.

## Links

- Website: https://www.monteengine.com/
- Docs: https://www.monteengine.com/docs
- LLM map: https://www.monteengine.com/llms.txt
- Full LLM docs: https://www.monteengine.com/llms-full.txt