Metadata-Version: 2.4
Name: a-memo
Version: 1.0.0
Summary: Lightweight memo CLI tool with SQLite + FTS5
Author-email: coderfee <ddc@coderfee.com>
License-Expression: MIT
License-File: LICENSE
Keywords: cli,fts,memo,note,sqlite
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Provides-Extra: png
Requires-Dist: playwright; extra == 'png'
Description-Content-Type: text/markdown

# a-memo

A lightweight memo CLI tool for AI agents with SQLite + FTS5, supporting tags, links, review, and share image generation.

[![PyPI version](https://img.shields.io/pypi/v/a-memo)](https://pypi.org/project/a-memo/)
[![GitHub](https://img.shields.io/github/license/coderfee/a-memo)](https://github.com/coderfee/a-memo)

## Install

```bash
pip install a-memo
```

Or with uv:

```bash
uv tool install a-memo
```

## Usage

```bash
memo add "content" #tag           # add memo
memo list                            # list all memos
memo search "keyword"                # full-text search
memo review --push                    # spaced repetition review
memo image 1                         # generate share image (PNG)
memo link 1 2                        # link two memos
memo flomo-import export.html        # import from flomo
```

## Data

Data stored at `~/.memo/`:
- `memo.db` - SQLite database
- `images/` - share images
- `history/` - review history

## Options

```bash
memo --help              # show all commands
memo --version           # show version
memo list #tag            # filter by tag
memo list --limit 20      # limit results
```

## Share Images

Default format is PNG (requires Playwright + Chrome).
SVG is always available:

```bash
memo image 1 --format svg
```

## License

MIT