bearcli 1.7.1__tar.gz → 1.7.3__tar.gz

{bearcli-1.7.1 → bearcli-1.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bearcli
-Version: 1.7.1
+Version: 1.7.3
 Summary: The missing open-source CLI for Bear notes - read, search, export, and manage your notes from the terminal
 Keywords: bear,notes,cli,markdown,macos
 Author: Michel Tricot
@@ -12,7 +12,7 @@ Classifier: Environment :: Console
 Classifier: Operating System :: MacOS
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Utilities
-Requires-Dist: bearkit==1.7.1
+Requires-Dist: bearkit==1.7.3
 Requires-Dist: fastmcp>=3.4.5
 Requires-Dist: textual>=8.2.8
 Requires-Dist: typer>=0.27.0
@@ -58,6 +58,26 @@ brew install michel-tricot/tap/bearcli   # or: uv tool install bearcli, pipx ins
 
 Or from a clone: `uv sync`, then `uv run bearcli --help`.
 
+### Troubleshooting
+
+The `bearcli` command can conflict with Bear's official CLI if both are
+installed — `which -a bearcli` shows which one your shell picks. To make
+this CLI take precedence, put its install directory first in your PATH:
+
+```sh
+# in your ~/.zshrc or ~/.bashrc
+export PATH="$(brew --prefix)/bin:$PATH"   # brew install
+export PATH="$HOME/.local/bin:$PATH"       # uv tool or pipx install
+```
+
+MCP configs are immune to the conflict: `bearcli mcp install` writes the
+absolute path of the very binary it is run from. If `bearcli` itself
+reaches the wrong tool, call ours by its full path once:
+
+```sh
+"$(brew --prefix)/bin/bearcli" mcp install   # or: ~/.local/bin/bearcli
+```
+
 ## Quick start
 
 ```sh
@@ -73,31 +93,40 @@ bearcli ui                         # full Bear client in the terminal
 
 Commands are grouped under `note` and `tag`.
 
+### Shortcuts
+
+The most common commands are also top-level aliases:
+
+```sh
+bearcli list        # alias for `note list`
+bearcli search      # alias for `note search`
+bearcli get         # alias for `note get`
+bearcli open        # alias for `note open`
+bearcli create      # alias for `note create`
+```
+
 ### Browse & read
 
 ```sh
 bearcli note list                            # 20 most recently modified
-bearcli list                                 # shortcut for `note list`
 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       # shortcut for `note get`; a unique id prefix (4+ chars) works everywhere
-bearcli get C44D09DC-... --meta              # with YAML-style frontmatter
-bearcli get C44D09DC-... -r                  # rewrite attachment refs to absolute paths
-bearcli get C44D09DC-... --redact-secrets    # secrets replaced by placeholders
-bearcli open C44D09DC-...                    # open in the Bear app (shortcut for `note open`)
-bearcli ui                                   # Bear in the terminal: search, edit, tag
-bearcli stats                                # counts, words, top tags, notes per year
+bearcli note get C44D09DC                    # a unique id prefix (4+ chars) works everywhere
+bearcli note get C44D09DC-... --meta         # with YAML-style frontmatter
+bearcli note get C44D09DC-... -r             # rewrite attachment refs to absolute paths
+bearcli note get C44D09DC-... --redact-secrets   # secrets replaced by placeholders
+bearcli note open C44D09DC-...               # open in the Bear app
 ```
 
 ### Search
 
 ```sh
-bearcli search "invoice" --tag work -n 5     # case-insensitive substring (shortcut for `note search`)
-bearcli search "quarterly planing" --fuzzy   # typo-tolerant, ranked by score
+bearcli note search "invoice" --tag work -n 5   # case-insensitive substring
+bearcli note search "quarterly planing" --fuzzy  # typo-tolerant, ranked by score
 ```
 
 ### Write
@@ -106,10 +135,10 @@ Writes go through the Bear app and are verified before the command reports
 success.
 
 ```sh
-bearcli create "Meeting notes" --text "agenda..." --tag work   # shortcut for `note create`
+bearcli note 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 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-...
@@ -164,6 +193,7 @@ 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
+bearcli stats -f json                        # library totals: counts, words, top tags
 ```
 
 Dates are ISO (`2026-07-01` or `2026-07-01T14:30`). Override the database

{bearcli-1.7.1 → bearcli-1.7.3}/README.md

@@ -34,6 +34,26 @@ brew install michel-tricot/tap/bearcli   # or: uv tool install bearcli, pipx ins
 
 Or from a clone: `uv sync`, then `uv run bearcli --help`.
 
+### Troubleshooting
+
+The `bearcli` command can conflict with Bear's official CLI if both are
+installed — `which -a bearcli` shows which one your shell picks. To make
+this CLI take precedence, put its install directory first in your PATH:
+
+```sh
+# in your ~/.zshrc or ~/.bashrc
+export PATH="$(brew --prefix)/bin:$PATH"   # brew install
+export PATH="$HOME/.local/bin:$PATH"       # uv tool or pipx install
+```
+
+MCP configs are immune to the conflict: `bearcli mcp install` writes the
+absolute path of the very binary it is run from. If `bearcli` itself
+reaches the wrong tool, call ours by its full path once:
+
+```sh
+"$(brew --prefix)/bin/bearcli" mcp install   # or: ~/.local/bin/bearcli
+```
+
 ## Quick start
 
 ```sh
@@ -49,31 +69,40 @@ bearcli ui                         # full Bear client in the terminal
 
 Commands are grouped under `note` and `tag`.
 
+### Shortcuts
+
+The most common commands are also top-level aliases:
+
+```sh
+bearcli list        # alias for `note list`
+bearcli search      # alias for `note search`
+bearcli get         # alias for `note get`
+bearcli open        # alias for `note open`
+bearcli create      # alias for `note create`
+```
+
 ### Browse & read
 
 ```sh
 bearcli note list                            # 20 most recently modified
-bearcli list                                 # shortcut for `note list`
 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       # shortcut for `note get`; a unique id prefix (4+ chars) works everywhere
-bearcli get C44D09DC-... --meta              # with YAML-style frontmatter
-bearcli get C44D09DC-... -r                  # rewrite attachment refs to absolute paths
-bearcli get C44D09DC-... --redact-secrets    # secrets replaced by placeholders
-bearcli open C44D09DC-...                    # open in the Bear app (shortcut for `note open`)
-bearcli ui                                   # Bear in the terminal: search, edit, tag
-bearcli stats                                # counts, words, top tags, notes per year
+bearcli note get C44D09DC                    # a unique id prefix (4+ chars) works everywhere
+bearcli note get C44D09DC-... --meta         # with YAML-style frontmatter
+bearcli note get C44D09DC-... -r             # rewrite attachment refs to absolute paths
+bearcli note get C44D09DC-... --redact-secrets   # secrets replaced by placeholders
+bearcli note open C44D09DC-...               # open in the Bear app
 ```
 
 ### Search
 
 ```sh
-bearcli search "invoice" --tag work -n 5     # case-insensitive substring (shortcut for `note search`)
-bearcli search "quarterly planing" --fuzzy   # typo-tolerant, ranked by score
+bearcli note search "invoice" --tag work -n 5   # case-insensitive substring
+bearcli note search "quarterly planing" --fuzzy  # typo-tolerant, ranked by score
 ```
 
 ### Write
@@ -82,10 +111,10 @@ Writes go through the Bear app and are verified before the command reports
 success.
 
 ```sh
-bearcli create "Meeting notes" --text "agenda..." --tag work   # shortcut for `note create`
+bearcli note 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 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-...
@@ -140,6 +169,7 @@ 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
+bearcli stats -f json                        # library totals: counts, words, top tags
 ```
 
 Dates are ISO (`2026-07-01` or `2026-07-01T14:30`). Override the database

{bearcli-1.7.1 → bearcli-1.7.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bearcli"
-version = "1.7.1"
+version = "1.7.3"
 description = "The missing open-source CLI for Bear notes - read, search, export, and manage your notes from the terminal"
 readme = "README.md"
 keywords = ["bear", "notes", "cli", "markdown", "macos"]
@@ -18,7 +18,7 @@ license = "MIT"
 license-files = ["LICENSE"]
 requires-python = ">=3.13"
 dependencies = [
-    "bearkit==1.7.1",
+    "bearkit==1.7.3",
     "fastmcp>=3.4.5",
     "textual>=8.2.8",
     "typer>=0.27.0",

{bearcli-1.7.1 → bearcli-1.7.3}/src/bearcli/cli/mcp.py

@@ -28,7 +28,13 @@ def run(
 
 
 def _bearcli_command() -> str:
-    return shutil.which("bearcli") or sys.argv[0] or "bearcli"
+    # Prefer the binary we are running from: a PATH lookup could find Bear's
+    # official CLI, which shadows ours under the same name. absolute() (not
+    # resolve()) keeps brew's stable bin/ symlink out of the versioned Cellar.
+    exe = Path(sys.argv[0])
+    if exe.name == "bearcli" and exe.is_file():
+        return str(exe.absolute())
+    return shutil.which("bearcli") or "bearcli"
 
 
 @dataclass(frozen=True)