Metadata-Version: 2.5
Name: minutes-cli
Version: 0.2.1
Summary: Project-centric meeting notes and task tracker for the command line
Project-URL: Repository, https://github.com/ucyo/minutes
Author-email: Ugur Cayoglu <cayoglu@me.com>
License: MIT
Requires-Python: >=3.11
Requires-Dist: prompt-toolkit
Requires-Dist: rich
Requires-Dist: typer
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# minutes

Project-centric meeting notes and task tracker for the command line.

Capture notes from meetings, track actions and decisions per project, and get a clean weekly summary before giving updates.

## Getting started

**Requirements:** Python 3.11+

```bash
pip install -e .
```

**Add entries after a meeting:**

```bash
minutes logs
```

Press `a` to open the add form. The project is prefilled from the selected entry (or locked to `--project` when given). Then enter entries one per line:

```
*  decision     → * Drop v1 endpoints by Q3
!  action       → ! Write migration guide @fri
>  waiting      → > Spec approval from Marco
   note         → Just a note, no prefix needed
```

Press Enter to save each entry; an empty entry line closes the form. Each entry is saved immediately.

For one-off entries from scripts, add inline:

```bash
minutes logs --add "Write migration guide @fri" --project api-migration
```

**Enable shell completion (once):**

```bash
minutes --install-completion
```

After restarting your shell, `minutes logs -p <TAB>` will autocomplete project names from your store.

**Browse entries:**

```bash
minutes logs                          # all projects, all entries
minutes logs --project api-migration  # one project in detail
minutes logs --since 14               # last 14 days
minutes logs --since mon              # since Monday
```

**Check open actions:**

```bash
minutes logs --open
```

**Web UI:**

```bash
minutes logs --web
```

Serves the same browse + add flow as a local web page at `http://127.0.0.1:8123` and opens your browser automatically. Use `--port` to pick another port, `--no-open` to skip opening the browser, and `--file` to point at a different store. Initial filters pass through: `minutes logs --web --project api-migration --since mon --open`. Stop with `Ctrl-C`.

## Running tests

```bash
make test
```

## Data

Entries are stored as JSONL at `~/.local/share/minutes/entries.jsonl`.

See [docs/whitepaper.md](docs/whitepaper.md) for the full specification.
