# AgentBoard

An Obsidian plugin that keeps a visual task board in sync with a Markdown todo file — in real time, in both directions. Designed for workflows where AI agents maintain the Markdown file while you interact with the board, though it works just as well as a standalone board for any Obsidian user.

## Features

- **Board view** — each `#`, `##`, or `###` section in your todo file becomes its own column
- **Real-time sync** — changes made in the Markdown file (including by external AI agents) instantly appear on the board, and vice versa
- **Critical tasks** — mark a task as critical via the `⋯` menu; text turns red and a `!` badge appears
- **Inline editing** — double-click any task to edit its text directly on the board
- **Rename columns** — double-click a column heading to rename it; the change writes back to the MD file
- **Reorder columns** — drag columns by the `⠿` handle without affecting the MD file structure
- **Completed tasks** — completed tasks collapse into a foldable section at the bottom of each column
- **Add tasks** — type directly on the board; new tasks are appended to the correct section in the MD file
- **Delete tasks** — remove a task from the board via the `⋯` menu
- **Obsidian wiki-links** — `[[note_name]]` links in task text render as clickable links; autocomplete shows while you type `[[`
- **Hover descriptions** — `About:` lines under section headings appear as tooltips on the column title
- **Source file link** — the active todo file is shown at the top of the board and is clickable

## Todo file format

AgentBoard reads any Markdown file that uses this structure:

```markdown
## Health
About: Physical and mental health items.

- [ ] Book dentist appointment
- [x] Start stretching routine (Critical)

## Finance
- [ ] Open savings account
- [ ] Review pension status (Critical)
```

- `#`, `##`, or `###` headings become columns
- `About:` (optional) provides hover tooltip text for the column
- `- [ ]` open tasks, `- [x]` completed tasks
- Append ` (Critical)` to a task line to mark it as critical

## Installation

### From the Obsidian community plugins directory

1. Open **Settings → Community plugins → Browse**
2. Search for **AgentBoard**
3. Click **Install**, then **Enable**

### Manual installation

1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/aniruddh-jammoria/obsidian-agentic-todolist/releases/latest)
2. Copy them into `<your vault>/.obsidian/plugins/agent-board/`
3. Enable the plugin in **Settings → Community plugins**

## Configuration

Open **Settings → AgentBoard** and set the path to your todo Markdown file (relative to the vault root, e.g. `todo.md` or `notes/todos.md`). The path field autocompletes from all `.md` files in your vault.

## Usage

- Open the board via the **checkbox icon** in the left ribbon, or run **Open AgentBoard** from the command palette
- **Add a task** — click `+ Add task` at the bottom of any column, type, and press Enter
- **Complete a task** — click the checkbox; the task moves to the Completed section
- **Edit a task** — double-click the task text, edit, then press Enter or click elsewhere
- **Critical / Delete** — hover over a task, click the `⋯` button, and choose from the menu
- **Rename a column** — double-click the column title, edit, press Enter
- **Reorder columns** — drag the `⠿` handle on any column header to a new position
- **Open source file** — click the filename link at the top of the board

## Development

```bash
git clone https://github.com/aniruddh-jammoria/obsidian-agentic-todolist
cd obsidian-agentic-todolist
npm install
npm run dev   # watch mode
npm run build # production build
```

Copy `main.js`, `manifest.json`, and `styles.css` into `<vault>/.obsidian/plugins/agent-board/` to test.

## License

[MIT](LICENSE)