A command-line tool for capturing screenshots and managing knowledge in Obris, your personal knowledge layer for AI. Save content to organized topics so you never start another AI chat from zero again. Requires Python 3.10+. Or run directly with uv: For desktop notifications with deep linking to your uploaded content: Generate an API key from your Obris dashboard. Don't have an account? Sign up. T
Add this skill
npx mdskills install obris-dev/obris-cliWell-documented CLI tool for screenshot capture and knowledge management with clear setup and usage examples
1# Obris CLI23A 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.45## Install67Requires Python 3.10+.89```bash10pip install obris-cli11```1213Or run directly with [uv](https://docs.astral.sh/uv/):1415```bash16uvx --from obris-cli obris --help17```1819### Optional: macOS notifications2021For desktop notifications with deep linking to your uploaded content:2223```bash24brew install terminal-notifier25```2627## Setup2829### 1. Get your API key3031Generate 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).3233### 2. Authenticate3435```bash36obris auth --key <your-api-key>37```3839This saves your key locally to `~/.obris/config.json` and detects your Scratch topic (the default destination for captures).4041### Environments4243You can configure separate API keys for `prod` and `dev` side by side:4445```bash46obris auth --key <prod-key> # saves to prod (default)47obris --env dev auth --key <dev-key> # saves to dev48```4950Use `--env` on any command to override the active environment:5152```bash53obris --env dev capture54obris --env dev topic list55```5657Set the default environment:5859```bash60obris env dev # switch default to dev61obris env # show current default62```6364## Usage6566### Capture a screenshot6768```bash69obris capture # screenshot + upload to Scratch70obris capture --name "my pic" # explicit name71obris capture --prompt # prompt for a name via dialog72obris capture --topic <id> # upload to a specific topic73```7475### Upload a file7677```bash78obris upload photo.png # upload to Scratch79obris upload photo.png --topic <id> # upload to a specific topic80```8182### Manage topics8384```bash85obris topic list # list all topics86obris topic list <topic_id> # list knowledge in a topic87```8889### Manage knowledge9091```bash92obris knowledge move <id> --topic <id> # move to another topic93obris knowledge delete <id> # delete a knowledge item94```9596## Hotkeys9798Bind 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.99100### Example: Alfred101102Create a workflow with a **Hotkey** trigger connected to a **Run Script** action (language: `/bin/zsh`):103104**Quick capture:**105106```zsh107/full/path/to/obris capture108```109110**Capture with name prompt:**111112```zsh113/full/path/to/obris capture --prompt114```115116> **Tip:** Use the full path to the `obris` binary since Alfred doesn't load your shell profile. Run `which obris` to find it.117118## Platform support119120| Platform | Capture | Upload / Topics / Knowledge |121|----------|---------|----------------------------|122| macOS | Yes | Yes |123| Linux | Yes | Yes |124| Windows | No | Yes |125126## Development127128```bash129git clone https://github.com/obris-dev/obris-cli.git130cd obris-cli131uv sync132```133134Run commands locally without installing:135136```bash137uv run obris --env dev auth --key <your-api-key>138uv run obris capture139uv run obris topic list140```141142### Publishing143144```bash145make publish # build and publish to PyPI146```147148## Privacy Policy149150This 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`.151152For the full privacy policy, see [obris.ai/privacy](https://obris.ai/privacy).153154## Support155156For 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).157158## License159160MIT
Full transparency — inspect the skill content before installing.