obris-cli 0.1.0__py3-none-any.whl

obris/capture.py

@@ -0,0 +1,49 @@
+import subprocess
+import sys
+import tempfile
+from datetime import datetime
+from pathlib import Path
+
+
+def take_screenshot():
+    timestamp = datetime.now().strftime("%Y-%m-%d at %H.%M.%S")
+    filename = f"capture {timestamp}.png"
+    path = Path(tempfile.gettempdir()) / filename
+
+    if sys.platform == "darwin":
+        cmd = ["screencapture", "-i", str(path)]
+    elif sys.platform.startswith("linux"):
+        cmd = ["scrot", "-s", str(path)]
+    else:
+        raise SystemExit(f"Unsupported platform: {sys.platform}")
+
+    result = subprocess.run(cmd)
+    if result.returncode != 0:
+        raise SystemExit("Screenshot cancelled.")
+
+    if not path.exists() or path.stat().st_size == 0:
+        raise SystemExit("Screenshot cancelled.")
+
+    return path
+
+
+def prompt_name():
+    if sys.platform == "darwin":
+        result = subprocess.run(
+            [
+                "osascript",
+                "-e",
+                'display dialog "Name this capture:" default answer ""',
+                "-e",
+                "text returned of result",
+            ],
+            capture_output=True,
+            text=True,
+        )
+        if result.returncode != 0:
+            raise SystemExit("Cancelled.")
+        return result.stdout.strip()
+    else:
+        import click
+
+        return click.prompt("Name this capture")

obris/cli.py

@@ -0,0 +1,137 @@
+from pathlib import Path
+
+import click
+
+from obris import capture, config, notify, topics, uploader
+
+
+@click.group()
+def cli():
+    """Obris CLI — capture and upload to your personal context layer."""
+
+
+@cli.command()
+@click.option("--key", required=True, help="Your Obris API key")
+@click.option("--base", default=None, help="API base URL (e.g. http://localhost:8000)")
+def auth(key, base):
+    """Save API key and detect scratch topic."""
+    cfg = config.load()
+    cfg["api_key"] = key
+    if base:
+        cfg["api_base"] = base.rstrip("/")
+    config.save(cfg)
+
+    # Find the Scratch topic
+    try:
+        all_topics = topics.list_topics()
+    except SystemExit:
+        click.echo("API key saved, but failed to fetch topics.")
+        return
+
+    scratch = next((t for t in all_topics if t.get("name") == "Scratch" and t.get("is_system")), None)
+    if scratch:
+        cfg["scratch_topic_id"] = scratch["id"]
+        config.save(cfg)
+        click.echo(f"Authenticated. Scratch topic: {scratch['id']}")
+    else:
+        click.echo("Authenticated. No 'Scratch' topic found — create one in the app.")
+
+
+@cli.command("capture")
+@click.option("--name", "cap_name", default=None, help="Display name for the capture")
+@click.option("--prompt", "prompt_name", is_flag=True, help="Prompt for a name via dialog")
+@click.option("--topic", default=None, help="Topic ID (defaults to Scratch)")
+def capture_cmd(cap_name, prompt_name, topic):
+    """Take a screenshot and upload it."""
+    topic_id = topic or config.get_scratch_topic_id()
+
+    try:
+        path = capture.take_screenshot()
+    except SystemExit:
+        notify.send("Obris", "Screenshot cancelled")
+        raise
+
+    if cap_name:
+        name = cap_name
+    elif prompt_name:
+        name = capture.prompt_name()
+        if not name:
+            raise SystemExit("Name is required.")
+    else:
+        name = path.stem
+    notify.send_quiet("Obris", "Uploading...")
+
+    try:
+        result = uploader.upload_file(topic_id, path, name)
+    except SystemExit as e:
+        notify.send("Obris", f"Upload failed")
+        raise
+
+    notify.send("Obris", f"Uploaded '{result.get('title', name)}'", url=notify.topic_url(topic_id))
+    click.echo(f"Uploaded '{result.get('title', name)}'")
+    click.echo(f"  ID: {result['id']}")
+
+    path.unlink(missing_ok=True)
+
+
+@cli.command()
+@click.argument("filepath", type=click.Path(exists=True, path_type=Path))
+@click.option("--topic", default=None, help="Topic ID (defaults to Scratch)")
+@click.option("--name", default=None, help="Display name (defaults to filename)")
+def upload(filepath, topic, name):
+    """Upload a file to a topic."""
+    topic_id = topic or config.get_scratch_topic_id()
+    name = name or filepath.name
+    result = uploader.upload_file(topic_id, filepath, name)
+    click.echo(f"Uploaded '{result.get('title', name)}'")
+    click.echo(f"  ID: {result['id']}")
+
+
+@cli.group("topic")
+def topic_group():
+    """Manage topics."""
+
+
+@topic_group.command("list")
+@click.argument("topic_id", required=False)
+def topic_list(topic_id):
+    """List all topics, or knowledge items in a specific topic."""
+    if topic_id:
+        items = topics.list_knowledge(topic_id)
+        if not items:
+            click.echo("No items found.")
+            return
+        click.echo(f"{'ID':<28}{'TITLE':<38}CREATED")
+        for item in items:
+            created = item.get("created_at", "")[:16].replace("T", " ")
+            click.echo(f"{item['id']:<28}{item.get('title', ''):<38}{created}")
+    else:
+        all_topics = topics.list_topics()
+        if not all_topics:
+            click.echo("No topics found.")
+            return
+        click.echo(f"{'ID':<28}{'NAME':<22}ITEMS")
+        for t in all_topics:
+            click.echo(f"{t['id']:<28}{t['name']:<22}{t.get('item_count', 0)}")
+
+
+@cli.group("knowledge")
+def knowledge_group():
+    """Manage knowledge items."""
+
+
+@knowledge_group.command("move")
+@click.argument("knowledge_id")
+@click.option("--topic", required=True, help="Destination topic ID")
+def knowledge_move(knowledge_id, topic):
+    """Move a knowledge item to another topic."""
+    result = topics.move_knowledge(knowledge_id, topic)
+    click.echo(f"Moved to {result.get('topic_name', topic)}")
+
+
+@knowledge_group.command("delete")
+@click.argument("knowledge_id")
+def knowledge_delete(knowledge_id):
+    """Delete a knowledge item."""
+    topics.delete_knowledge(knowledge_id)
+    click.echo(f"Deleted {knowledge_id}")

obris/config.py

@@ -0,0 +1,42 @@
+import json
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".obris"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+DEFAULT_CONFIG = {
+    "api_key": "",
+    "api_base": "https://api.obris.ai",
+    "scratch_topic_id": "",
+}
+
+
+def load():
+    if not CONFIG_FILE.exists():
+        return dict(DEFAULT_CONFIG)
+    return {**DEFAULT_CONFIG, **json.loads(CONFIG_FILE.read_text())}
+
+
+def save(config):
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(config, indent=2) + "\n")
+
+
+def get_api_key():
+    cfg = load()
+    key = cfg.get("api_key")
+    if not key:
+        raise SystemExit("Not authenticated. Run: obris auth --key <key>")
+    return key
+
+
+def get_api_base():
+    return load().get("api_base", DEFAULT_CONFIG["api_base"])
+
+
+def get_scratch_topic_id():
+    cfg = load()
+    tid = cfg.get("scratch_topic_id")
+    if not tid:
+        raise SystemExit("No scratch topic configured. Run: obris auth --key <key>")
+    return tid

obris/notify.py

@@ -0,0 +1,70 @@
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+ICON_PATH = str(Path(__file__).parent / "assets" / "icon.png")
+
+# api.obris.ai -> app.obris.ai, localhost:8000 -> localhost:3001
+APP_BASE_MAP = {
+    "https://api.obris.ai": "https://app.obris.ai",
+    "http://localhost:8000": "http://localhost:3001",
+}
+
+_has_notifier = sys.platform == "darwin" and shutil.which("terminal-notifier") is not None
+
+
+def _get_app_base():
+    from obris.config import get_api_base
+    api_base = get_api_base()
+    return APP_BASE_MAP.get(api_base, api_base.replace("api.", "app."))
+
+
+def _osascript_notify(title, message):
+    subprocess.run([
+        "osascript", "-e",
+        f'display notification "{message}" with title "{title}"',
+    ])
+
+
+def send(title, message, url=None):
+    if sys.platform != "darwin":
+        import click
+        click.echo(f"{title}: {message}")
+        return
+
+    if _has_notifier:
+        cmd = [
+            "terminal-notifier",
+            "-title", title,
+            "-message", message,
+            "-contentImage", ICON_PATH,
+            "-sound", "default",
+        ]
+        if url:
+            cmd += ["-open", url]
+        subprocess.run(cmd)
+    else:
+        _osascript_notify(title, message)
+
+
+def send_quiet(title, message):
+    """Notification without sound (for transient states like 'Uploading...')."""
+    if sys.platform != "darwin":
+        import click
+        click.echo(f"{title}: {message}")
+        return
+
+    if _has_notifier:
+        subprocess.run([
+            "terminal-notifier",
+            "-title", title,
+            "-message", message,
+            "-contentImage", ICON_PATH,
+        ])
+    else:
+        _osascript_notify(title, message)
+
+
+def topic_url(topic_id):
+    return f"{_get_app_base()}/topics/{topic_id}"

obris/topics.py

@@ -0,0 +1,49 @@
+import requests
+
+from obris.config import get_api_base, get_api_key
+
+
+def _headers():
+    return {"X-API-Key": get_api_key()}
+
+
+def _unwrap(data):
+    """Handle paginated ({"results": [...]}) or plain list responses."""
+    if isinstance(data, dict) and "results" in data:
+        return data["results"]
+    return data
+
+
+def list_topics():
+    resp = requests.get(f"{get_api_base()}/v1/topics", headers=_headers())
+    if not resp.ok:
+        raise SystemExit(f"Failed to list topics ({resp.status_code}): {resp.text}")
+    return _unwrap(resp.json())
+
+
+def list_knowledge(topic_id):
+    resp = requests.get(
+        f"{get_api_base()}/v1/topics/{topic_id}/knowledge", headers=_headers()
+    )
+    if not resp.ok:
+        raise SystemExit(f"Failed to list knowledge ({resp.status_code}): {resp.text}")
+    return _unwrap(resp.json())
+
+
+def delete_knowledge(knowledge_id):
+    resp = requests.delete(
+        f"{get_api_base()}/v1/knowledge/detail/{knowledge_id}", headers=_headers()
+    )
+    if not resp.ok:
+        raise SystemExit(f"Delete failed ({resp.status_code}): {resp.text}")
+
+
+def move_knowledge(knowledge_id, topic_id):
+    resp = requests.post(
+        f"{get_api_base()}/v1/knowledge/detail/{knowledge_id}/move",
+        headers=_headers(),
+        json={"topic_id": topic_id},
+    )
+    if not resp.ok:
+        raise SystemExit(f"Move failed ({resp.status_code}): {resp.text}")
+    return resp.json()

obris/uploader.py

@@ -0,0 +1,25 @@
+import mimetypes
+
+import requests
+
+from obris.config import get_api_base, get_api_key
+
+
+def upload_file(topic_id, filepath, name):
+    url = f"{get_api_base()}/v1/knowledge/upload"
+    headers = {"X-API-Key": get_api_key()}
+    filename = filepath.name if hasattr(filepath, "name") else str(filepath)
+    mime_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+
+    with open(filepath, "rb") as f:
+        resp = requests.post(
+            url,
+            headers=headers,
+            files={"file": (filename, f, mime_type)},
+            data={"topic_id": topic_id, "title": name},
+        )
+
+    if not resp.ok:
+        raise SystemExit(f"Upload failed ({resp.status_code}): {resp.text}")
+
+    return resp.json()

obris_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: obris-cli
+Version: 0.1.0
+Summary: CLI for capturing screenshots and managing knowledge in Obris
+Project-URL: Homepage, https://obris.ai
+Project-URL: Repository, https://github.com/obris-dev/obris-cli
+Project-URL: Documentation, https://docs.obris.ai
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,capture,cli,knowledge-management,obris,screenshot,second-brain
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.28
+Description-Content-Type: text/markdown
+
+# Obris CLI
+
+A command-line tool for capturing screenshots and managing knowledge in [Obris](https://obris.ai), your personal knowledge layer for AI. Save content to organized topics so you never start another AI chat from zero again.
+
+## Install
+
+Requires Python 3.10+.
+
+```bash
+pip install obris-cli
+```
+
+Or run directly with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uvx obris-cli --help
+```
+
+### Optional: macOS notifications
+
+For desktop notifications with deep linking to your uploaded content:
+
+```bash
+brew install terminal-notifier
+```
+
+## Setup
+
+### 1. Get your API key
+
+Generate an API key from your [Obris dashboard](https://app.obris.ai/api-keys). Don't have an account? [Sign up](https://app.obris.ai/signup).
+
+### 2. Authenticate
+
+```bash
+obris auth --key <your-api-key>
+```
+
+This saves your key locally to `~/.obris/config.json` and detects your Scratch topic (the default destination for captures).
+
+## Usage
+
+### Capture a screenshot
+
+```bash
+obris capture                       # screenshot + upload to Scratch
+obris capture --name "my pic"       # explicit name
+obris capture --prompt              # prompt for a name via dialog
+obris capture --topic <id>          # upload to a specific topic
+```
+
+### Upload a file
+
+```bash
+obris upload photo.png              # upload to Scratch
+obris upload photo.png --topic <id> # upload to a specific topic
+```
+
+### Manage topics
+
+```bash
+obris topic list                    # list all topics
+obris topic list <topic_id>         # list knowledge in a topic
+```
+
+### Manage knowledge
+
+```bash
+obris knowledge move <id> --topic <id>  # move to another topic
+obris knowledge delete <id>             # delete a knowledge item
+```
+
+## Hotkeys
+
+Bind keyboard shortcuts to capture commands using any automation tool — [Alfred](https://www.alfredapp.com/), [Raycast](https://www.raycast.com/), [Keyboard Maestro](https://www.keyboardmaestro.com/), macOS Shortcuts, etc.
+
+### Example: Alfred
+
+Create a workflow with a **Hotkey** trigger connected to a **Run Script** action (language: `/bin/zsh`):
+
+**Quick capture:**
+
+```zsh
+/full/path/to/obris capture
+```
+
+**Capture with name prompt:**
+
+```zsh
+/full/path/to/obris capture --prompt
+```
+
+> **Tip:** Use the full path to the `obris` binary since Alfred doesn't load your shell profile. Run `which obris` to find it.
+
+## Platform support
+
+| Platform | Capture | Upload / Topics / Knowledge |
+|----------|---------|----------------------------|
+| macOS    | Yes | Yes |
+| Linux    | Yes | Yes |
+| Windows  | No  | Yes |
+
+## Development
+
+```bash
+git clone https://github.com/obris-dev/obris-cli.git
+cd obris-cli
+uv sync
+```
+
+Run commands locally without installing:
+
+```bash
+uv run obris auth --key <your-api-key> --base http://localhost:8000
+uv run obris capture
+uv run obris topic list
+```
+
+### Publishing
+
+```bash
+make publish   # build and publish to PyPI
+```
+
+## Privacy Policy
+
+This CLI sends your Obris API key to the Obris API (`api.obris.ai`) to authenticate requests. It uploads files and retrieves topic and knowledge data from your account. No data is stored beyond the local config file at `~/.obris/config.json`.
+
+For the full privacy policy, see [obris.ai/privacy](https://obris.ai/privacy).
+
+## Support
+
+For issues or questions, contact [support@obris.ai](mailto:support@obris.ai) or open an issue on [GitHub](https://github.com/obris-dev/obris-cli/issues).
+
+## License
+
+MIT

obris_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+obris/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+obris/capture.py,sha256=p3FDHDHNllo-D3htYH9OHr6G__H0UTrCAXYFuPH8MAc,1327
+obris/cli.py,sha256=CMVGRkhkF5RrYew-i8Rq1guvuQA2uBWJw7mrv2MJ80M,4463
+obris/config.py,sha256=0EXugY6s_CtHCv4FrcPczrMXt8qw54HB3nlMPy04be8,968
+obris/notify.py,sha256=hSfYLRIcasnHy8F5HlwfVFER-hXBaXEBPFEUimpi_4U,1788
+obris/topics.py,sha256=uE8Pbd-yl7jKBGy0N3EmvWjRVRojSxU3rYd5iT_j-Kc,1416
+obris/uploader.py,sha256=oL4RPcLscuN7dkR4SESihM-siQM2oXONfmc41hQWSxs,735
+obris/assets/icon.png,sha256=Bj88FinJLxlnPuINM_b8plw1Q6akHnqsWS4RkhfydYM,12340
+obris_cli-0.1.0.dist-info/METADATA,sha256=jTfXULIOH_mvT_BSE64TROEYSXveI7dm9LaJAcLNhjo,3912
+obris_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+obris_cli-0.1.0.dist-info/entry_points.txt,sha256=7ujVi_V6PQxISgOZ1Jyc7WYympakAYsxaDdngWmcKug,40
+obris_cli-0.1.0.dist-info/licenses/LICENSE,sha256=HDIIGoyIe7XW8UG0Q-TVBneWsfDijfUhdelvyCgbJBM,1061
+obris_cli-0.1.0.dist-info/RECORD,,

obris_cli-0.1.0.dist-info/WHEEL

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

obris_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+obris = obris.cli:cli

obris_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Obris
+
+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.