skope 🔎
Not a notebook. A journal 📰. Agent driven.
Status
🚧 v0, walking skeleton. macOS dev only.
Install
skope ships as a PyPI wheel — a self-contained binary:
uv tool install skope # or: pip install skope
skope tui # opens a terminal client (auto-spawns the daemon)
uvx skope tui # zero-install trial
skope runs Python cells with whatever python3 is on PATH, not its own
install env — so activate your project's environment first (or use
uv run skope tui) to give cells access to your packages. Override explicitly
with --python /path/to/python.
Requirements (development)
- Rust stable (pinned in
rust-toolchain.toml) justfor repo recipes
Quickstart
With ANTHROPIC_API_KEY set, the agent is enabled. The header has an L2/L3
autonomy toggle: at L2 the agent runs cells and edits files automatically
but always prompts on file_delete; at L3 everything inside the writable
allow-list is auto-allowed.
Writable allow-list (hardcoded v0):
src/**,experiments/**,tests/**data/README.md,pyproject.toml,.gitignore
Anything outside this list is hard-denied (no prompt, no override). In
particular .skope/ (where skope keeps its own state) is off-limits.
The model can force a prompt at any level by setting
require_approval: true on a write tool call.
Tools (v0)
| Tool | Purpose |
|---|---|
cell_run |
Run a Python cell on the persistent kernel. |
read |
Read a workspace file (with optional 1-indexed line range). |
glob |
List files matching a * / ** / ? pattern. |
grep |
Regex search across the workspace. |
file_create |
Create a new file inside the allow-list. |
file_edit |
Replace one exact substring; read-before-edit enforced. |
file_delete |
Delete a file; prompts at L2, auto at L3. |
file_move |
Move/rename a file; both ends must be in the allow-list. |
Every write tool snapshots the prior state under
.skope/sessions/<session-id>/snapshots/<step_id>/ for future revert support.
Watch this space.
© Probabl. Licensing: ask :probabl.
Metadata
Release files for skope 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| skope-0.0.1-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Release files / skope-0.0.1-py3-none-macosx_11_0_arm64.whl
| Download URL | skope-0.0.1-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 4.4 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ad4df21e722df5d46fffa53000505586bd1de748a5bdc23e3099c646ce6fee30
|
|
BLAKE2b-256 checksum How to use checksums |
582ad5df1acc667d1e3d9217e84161f68afc47f50de544097429378d501b7ffb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|