# planview

A beautiful local viewer for MDX plan files.

## Quick start

```bash
npm install
npm run dev
```

Open [http://localhost:3000](http://localhost:3000).

## Configuration

By default, planview looks for plans in `../coe.agentic-engineering-playbook/plans` relative to the project root.

To point at a different directory, set `PLANS_DIR` in `.env.local`:

```
PLANS_DIR=/absolute/path/to/your/plans
# or relative to project root:
PLANS_DIR=../my-other-repo/plans
```

## Plan structure

Each plan lives in its own subdirectory:

```
plans/
  my-feature/
    plan.mdx        ← required
    comments.json   ← auto-created when you add comments
```

The `plan.mdx` file can have frontmatter:

```mdx
---
title: My Feature Plan
---

# Content here
```

## Features

- **Browse** all plans on the home page
- **Read** plans with full MDX rendering (headings, tables, code blocks)
- **Comment** — click any h2/h3 heading to add a note
- **History** — see git log for each plan file in the side drawer
- **Export** — click "Export HTML" to print/save as PDF
