beakr-cli 0.2.0__tar.gz → 0.2.1__tar.gz

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/.claude/skills/beakr/SKILL.md

@@ -5,7 +5,9 @@ description: "Access your organization's knowledge base, research questions with
 
 # Beakr Knowledge Base
 
-Use the Beakr MCP tools to search, read, research, and write to the organization's knowledge base.
+Beakr is the team's organizational memory. Teams write decisions, processes, ownership, and dated events here so that 6 months later the answer to "why did we do X" is one search away instead of lost in Slack archives or tribal knowledge.
+
+Use the Beakr MCP tools to search and read existing knowledge — and to add to it when the conversation produces something durable.
 
 ## When to use
 
@@ -13,6 +15,37 @@ Use the Beakr MCP tools to search, read, research, and write to the organization
 - User wants to look something up ("What do we know about X?", "Who owns Y?")
 - User wants to research a topic across documents and connected services
 - User wants to create, update, or audit knowledge base pages
+- **The conversation itself surfaces durable information worth capturing** (see "Proactive capture" below)
+
+## Proactive capture
+
+You are not just a read interface. When the conversation produces something durable, **propose adding it — don't wait to be asked**.
+
+**Capture when all of:**
+- **Durable**: would still matter in 6 months
+- **Shareable**: others would benefit, not just this user right now
+- **Not already in Beakr**: check with `kb_search` first
+- **In scope**: the user can write to it (their personal project, or a team project they belong to — confirm with `list_projects`)
+
+**Good candidates:**
+- Decisions with rationale ("we chose X over Y because…")
+- Named processes ("here's how we onboard a customer")
+- Role / ownership assignments ("Alex owns billing")
+- Dated events: launches, hires, fundraising rounds, incidents
+- External relationships: investors, partners, key vendors
+- Recurring questions you just answered
+
+**Skip:**
+- Debugging traces, transient state
+- Information already in source code, git history, Linear/Jira tickets
+- Hot takes, speculation, "thinking out loud"
+- Anything the user clearly considers ephemeral
+
+**Etiquette:**
+- **Surface the suggestion before writing**: "This decision about X seems worth capturing — want me to propose it for your wiki?"
+- Never auto-write. Always propose, always wait for explicit OK.
+- One capture offer per significant thread — don't pepper the user.
+- Cite the current session as `conversation:<short-id>` with `meta.excerpt` so the source is traceable.
 
 ## Core tools
 

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: beakr-cli
-Version: 0.2.0
+Version: 0.2.1
 Summary: CLI and MCP server for Beakr's knowledge base
 Project-URL: Homepage, https://thebeakr.com
 Project-URL: Repository, https://github.com/BeakrHub/beakr-cli
@@ -45,9 +45,11 @@ If you only want one, install both anyway — they don't conflict and the MCP se
 ## One-line install
 
 ```bash
-curl -fsSL https://install.thebeakr.com | sh
+curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh
 ```
 
+(Once `install.thebeakr.com` is wired up, `curl -fsSL https://install.thebeakr.com | sh` will work too — same script, prettier URL.)
+
 That's it. The script:
 
 1. Installs [`uv`](https://github.com/astral-sh/uv) if missing (no system Python required — `uv` ships its own).
@@ -62,10 +64,10 @@ Pass flags through the pipe if you want non-interactive behavior:
 
 ```bash
 # Skip the API key prompt (auth later with `beakr auth login`)
-curl -fsSL https://install.thebeakr.com | sh -s -- --no-auth
+curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh -s -- --no-auth
 
 # Only wire Claude Code, force-overwrite anything that exists
-curl -fsSL https://install.thebeakr.com | sh -s -- --client claude --force
+curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh -s -- --client claude --force
 ```
 
 ## Manual install

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/README.md

@@ -14,9 +14,11 @@ If you only want one, install both anyway — they don't conflict and the MCP se
 ## One-line install
 
 ```bash
-curl -fsSL https://install.thebeakr.com | sh
+curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh
 ```
 
+(Once `install.thebeakr.com` is wired up, `curl -fsSL https://install.thebeakr.com | sh` will work too — same script, prettier URL.)
+
 That's it. The script:
 
 1. Installs [`uv`](https://github.com/astral-sh/uv) if missing (no system Python required — `uv` ships its own).
@@ -31,10 +33,10 @@ Pass flags through the pipe if you want non-interactive behavior:
 
 ```bash
 # Skip the API key prompt (auth later with `beakr auth login`)
-curl -fsSL https://install.thebeakr.com | sh -s -- --no-auth
+curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh -s -- --no-auth
 
 # Only wire Claude Code, force-overwrite anything that exists
-curl -fsSL https://install.thebeakr.com | sh -s -- --client claude --force
+curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh -s -- --client claude --force
 ```
 
 ## Manual install

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/install.sh

@@ -2,11 +2,13 @@
 # install.sh - Bootstrap the Beakr CLI and wire it into Claude Code / Codex.
 #
 # Usage:
-#   curl -fsSL https://install.thebeakr.com | sh
+#   curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh
+#
+# (Future: curl -fsSL https://install.thebeakr.com | sh — same script, prettier URL.)
 #
 # Pass flags through to `beakr setup`:
-#   curl -fsSL https://install.thebeakr.com | sh -s -- --no-auth
-#   curl -fsSL https://install.thebeakr.com | sh -s -- --client claude --force
+#   curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh -s -- --no-auth
+#   curl -fsSL https://raw.githubusercontent.com/BeakrHub/beakr-cli/main/install.sh | sh -s -- --client claude --force
 
 set -eu
 
@@ -29,9 +31,18 @@ fi
 
 # 2. Install (or upgrade) the beakr CLI as a uv tool. This puts a real `beakr`
 #    binary on PATH at ~/.local/bin/beakr — no `uvx` indirection at runtime.
+#
+# Three cases:
+#   a) uv-managed beakr-cli already installed -> upgrade
+#   b) a `beakr` binary exists from another install method (pipx, pip)
+#      -> install with --force so uv replaces it
+#   c) nothing installed yet -> plain install
 if uv tool list 2>/dev/null | grep -q '^beakr-cli '; then
   log "Upgrading beakr-cli ..."
   uv tool upgrade beakr-cli
+elif command -v beakr >/dev/null 2>&1; then
+  log "Existing 'beakr' binary detected from another install method; reinstalling via uv (--force) ..."
+  uv tool install --force beakr-cli
 else
   log "Installing beakr-cli ..."
   uv tool install beakr-cli

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "beakr-cli"
-version = "0.2.0"
+version = "0.2.1"
 description = "CLI and MCP server for Beakr's knowledge base"
 readme = "README.md"
 license = "MIT"

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/src/beakr_cli/__init__.py

@@ -1,3 +1,3 @@
 """Beakr CLI -- command-line and MCP server for Beakr's knowledge base."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/src/beakr_cli/commands/install.py

@@ -7,6 +7,7 @@ import json
 import os
 import shutil
 import subprocess
+import sys
 from enum import Enum
 from pathlib import Path
 
@@ -404,14 +405,18 @@ def _unregister_codex_mcp() -> None:
 # ---------------------------------------------------------------------------
 
 
-def _maybe_auth() -> None:
-    """Prompt for an API key and verify it, unless one is already configured."""
+def _identity_summary(data: dict) -> str:
+    user = data.get("user", data)
+    org = data.get("personal_org", data)
+    name = user.get("display_name") or user.get("primary_email") or "unknown"
+    org_name = org.get("name") or org.get("slug") or "unknown"
+    return f"{name} in {org_name}"
+
+
+def _prompt_and_save_new_key() -> None:
     from beakr_cli import config as beakr_config
     from beakr_cli.client import api_get
 
-    if os.environ.get("BEAKR_API_KEY") or beakr_config.get("api_key"):
-        return
-
     console.print("\n[bold]Beakr authentication[/bold]")
     console.print("Get an API key at [cyan]https://thebeakr.com/settings/api-keys[/cyan]")
     api_key = typer.prompt("API key", hide_input=True)
@@ -425,13 +430,56 @@ def _maybe_auth() -> None:
         beakr_config.delete_key("api_key")
         err_console.print(f"[red]Auth failed:[/red] {exc}")
         raise typer.Exit(1) from exc
+    console.print(f"Authenticated as [bold]{_identity_summary(data)}[/bold]")
 
-    user = data.get("user", data)
-    org = data.get("personal_org", data)
-    console.print(
-        f"Authenticated as [bold]{user.get('display_name', user.get('primary_email', 'unknown'))}[/bold] "
-        f"in [bold]{org.get('name', org.get('slug', 'unknown'))}[/bold]"
-    )
+
+def _maybe_auth() -> None:
+    """Confirm or replace an existing API key, or prompt for a new one."""
+    from beakr_cli import config as beakr_config
+    from beakr_cli.client import api_get
+
+    env_key = os.environ.get("BEAKR_API_KEY")
+    config_key = beakr_config.get("api_key")
+
+    # 1. Env var wins — verify and announce, don't prompt.
+    if env_key:
+        try:
+            data = api_get("/v1/me")
+            console.print(
+                f"Using [bold]$BEAKR_API_KEY[/bold] ([dim]{_identity_summary(data)}[/dim])"
+            )
+        except Exception as exc:
+            err_console.print(f"[red]$BEAKR_API_KEY didn't verify:[/red] {exc}")
+            raise typer.Exit(1) from exc
+        return
+
+    # 2. Stored key — verify, then ask whether to keep using it.
+    if config_key:
+        try:
+            data = api_get("/v1/me")
+            identity = _identity_summary(data)
+        except Exception:
+            err_console.print(
+                "[yellow]Existing API key didn't verify; let's get a new one.[/yellow]"
+            )
+            beakr_config.delete_key("api_key")
+            _prompt_and_save_new_key()
+            return
+
+        # Non-interactive (piped/CI): keep the existing verified key silently.
+        if not sys.stdin.isatty():
+            console.print(f"Using existing API key ([dim]{identity}[/dim])")
+            return
+
+        console.print(f"\nExisting API key found for [bold]{identity}[/bold].")
+        if typer.confirm("Use this key?", default=True):
+            return
+        beakr_config.delete_key("api_key")
+        _prompt_and_save_new_key()
+        return
+
+    # 3. Nothing configured — full prompt path.
+    _prompt_and_save_new_key()
 
 
 # ---------------------------------------------------------------------------

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/src/beakr_cli/mcp_server.py

@@ -12,7 +12,21 @@ from beakr_cli.client import get_async_client, scope_params
 mcp = FastMCP(
     "beakr",
     instructions=(
-        "Beakr -- your organization's knowledge base and connected services.\n\n"
+        "Beakr is the team's organizational memory and connected services. "
+        "Teams write decisions, processes, ownership, and dated events here so "
+        "that 6 months later the answer to 'why did we do X' is one search "
+        "away instead of lost in Slack archives or tribal knowledge.\n\n"
+        "RESPONSIBILITIES:\n"
+        "Use Beakr to answer questions about the user's org with citations. "
+        "When the conversation produces something durable (a decision with "
+        "rationale, a named process, an ownership assignment, a dated event, "
+        "a key relationship), propose adding it -- don't wait to be asked. "
+        "First check with kb_search that it isn't already captured, then "
+        "surface a brief suggestion before writing ('this seems worth "
+        "capturing -- want me to propose it?'). Never auto-write; always go "
+        "through proposals and wait for explicit acceptance. Cite the current "
+        "session as a 'conversation' inline source with meta.excerpt when the "
+        "information originates from this chat.\n\n"
         "TOOLS:\n"
         "- 'research': Primary tool. Ask any question and get a cited answer from the "
         "wiki, documents, and connected services (Slack, Gmail, Calendar, Jira, etc.). "

{beakr_cli-0.2.0 → beakr_cli-0.2.1}/uv.lock

@@ -63,7 +63,7 @@ wheels = [
 
 [[package]]
 name = "beakr-cli"
-version = "0.2.0"
+version = "0.2.1"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },