bearcli 1.0.0__py3-none-any.whl

bearcli-1.0.0.dist-info/METADATA

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: bearcli
+Version: 1.0.0
+Summary: The missing CLI for Bear notes — read, search, export, and manage your notes from the terminal
+Keywords: bear,notes,cli,markdown,macos
+Author: Michel Tricot
+Author-email: Michel Tricot <michel.tricot@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Dist: rapidfuzz>=3.14.5
+Requires-Dist: typer>=0.27.0
+Requires-Python: >=3.13
+Project-URL: Documentation, https://github.com/michel-tricot/bearcli/blob/main/docs/IMPLEMENTATION.md
+Project-URL: Homepage, https://michel-tricot.github.io/bearcli/
+Project-URL: Repository, https://github.com/michel-tricot/bearcli
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# 🐻 bearcli
+
+**The missing CLI for [Bear](https://bear.app) notes** — read, search, export, and
+manage your notes from the terminal.
+
+[![CI](https://github.com/michel-tricot/bearcli/actions/workflows/ci.yml/badge.svg)](https://github.com/michel-tricot/bearcli/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Python 3.13+](https://img.shields.io/badge/python-3.13%2B-blue.svg)](pyproject.toml)
+[![macOS](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](#)
+
+[**Website**](https://michel-tricot.github.io/bearcli/) ·
+[Commands](#commands) ·
+[How it works](docs/IMPLEMENTATION.md)
+
+</div>
+
+---
+
+Bear stores your notes in a local SQLite database. bearcli reads it directly in
+**read-only mode** — Bear doesn't even need to be running — and performs every
+write through Bear's own x-callback-url API, verifying each change against the
+database. Your notes are never touched behind Bear's back.
+
+## Install
+
+```sh
+uv tool install bearcli        # or: uvx bearcli, pipx install bearcli
+```
+
+Or from a clone: `uv sync`, then `uv run bearcli --help`.
+
+## Quick start
+
+```sh
+bearcli list                       # 20 most recently modified notes
+bearcli search "quarterly report"  # search titles, tags, and content
+bearcli get <note-id>              # print a note's markdown
+bearcli create "Idea" --tag inbox  # create a note
+bearcli export ~/bear-backup       # export everything as markdown folders
+```
+
+## Commands
+
+Commands are grouped under `note` and `tag`; the most common ones (`list`,
+`search`, `get`, `open`, `create`) also work directly as shortcuts.
+
+### Browse & read
+
+```sh
+bearcli note list                            # 20 most recently modified
+bearcli note list --limit 5 --tag work       # filters: tag (incl. nested), dates...
+bearcli note list --modified-after 2026-07-01
+bearcli note list --only pinned              # or: encrypted, trashed, archived
+bearcli note list --all --trashed --archived
+bearcli note list --ids                      # only identifiers, one per line
+
+bearcli get C44D09DC-7F0E-43BB-BEB8-67E3A389A448
+bearcli get C44D09DC-... --meta              # with YAML-style frontmatter
+bearcli get C44D09DC-... -r                  # rewrite attachment refs to absolute paths
+bearcli open C44D09DC-...                    # open in the Bear app
+```
+
+### Search
+
+```sh
+bearcli search "invoice" --tag work -n 5     # case-insensitive substring
+bearcli search "quarterly planing" --fuzzy   # typo-tolerant, ranked by score
+```
+
+### Write
+
+Writes go through Bear's x-callback-url API — the database itself is never
+written. These launch the Bear app if needed.
+
+```sh
+bearcli create "Meeting notes" --text "agenda..." --tag work
+echo "follow-up item" | bearcli note append C44D09DC-...
+bearcli note rename C44D09DC-... "New title"
+bearcli get C44D09DC-... | sed 's/foo/bar/' | bearcli note replace C44D09DC-...
+bearcli note attach C44D09DC-... screenshot.png   # ≤500 KB
+bearcli note archive C44D09DC-...
+bearcli note trash C44D09DC-...
+```
+
+### Tags
+
+```sh
+bearcli tag list                             # all tags with note counts
+bearcli note tag C44D09DC-... "work/ideas"   # add a tag to a note
+bearcli note untag C44D09DC-... "work/ideas" # remove a tag from a note
+bearcli tag rename old-name new-name         # across all notes
+bearcli tag delete old-name                  # across all notes (asks first)
+```
+
+### Export
+
+Every note becomes a self-contained directory — `<slug>/README.md` plus its
+attachments — with a generated index, so GitHub renders the whole export as a
+browsable tree.
+
+```sh
+bearcli export ~/bear-backup
+bearcli export ~/bear-backup --sync          # only rewrite notes that changed
+```
+
+## Scripting
+
+Every listing takes `--format` / `-f`: `table` (default), `json`, or
+tab-separated `text` built for pipes.
+
+```sh
+bearcli list -f json | jq -r '.[].title'
+bearcli list -f text | cut -f1               # text is: id, modified, tags, status, title
+```
+
+Dates use ISO format (`2026-07-01` or `2026-07-01T14:30`). The database path
+defaults to Bear's standard location and can be overridden with `--db` or the
+`BEAR_DB_PATH` environment variable. Encrypted notes are listed but their
+content cannot be read.
+
+## Development
+
+```sh
+uv sync
+uv run ruff format src/ && uv run ruff check src/
+uv run ty check src/
+uv run python scripts/check_docs.py          # docs must cover every command
+```
+
+Design notes and Bear database internals: [docs/IMPLEMENTATION.md](docs/IMPLEMENTATION.md).
+Contributor/agent guidelines: [AGENTS.md](AGENTS.md).
+
+## License
+
+[MIT](LICENSE) · not affiliated with [Shiny Frog](https://shinyfrog.app)

bearcli-1.0.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+bearcli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bearcli/actions.py,sha256=nKhu4iUjS6-SAvsJKvoTqPRa0mj9lD9zKAOFJKb9OZY,2430
+bearcli/cli.py,sha256=mBHHKdnlxDstXOROOVjChg8Tf9wz5y4kWYkJSkOOdlA,28276
+bearcli/db.py,sha256=zM25gOxrzUq5qRAts78oIMrFW4GU245FceuwO2DcLAA,9790
+bearcli/export.py,sha256=4Y2mwhhwsozpNpIBe7I2stzX85WdOG_7DLk7bmN8YfY,8244
+bearcli/search.py,sha256=BIqKn4Kqw4FOtbljcFUSGb5t5VhI36KrClfb1uIIrAs,4814
+bearcli-1.0.0.dist-info/licenses/LICENSE,sha256=6GQ08_KAylombOwcGnemMQM8Ai39XsWdW25vHPE6v_s,1070
+bearcli-1.0.0.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+bearcli-1.0.0.dist-info/entry_points.txt,sha256=JLYgSgDfzdtHixbjhWt44WoGznm7UqxuD0Xejn6qncU,45
+bearcli-1.0.0.dist-info/METADATA,sha256=Ko9LGhf__cvXdh3hdBkb1U8zqJyBZpUgPlKnO-YYK6U,5569
+bearcli-1.0.0.dist-info/RECORD,,

bearcli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.8.24
+Root-Is-Purelib: true
+Tag: py3-none-any

bearcli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+bearcli = bearcli.cli:app
+

bearcli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michel Tricot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.