Skip to main content

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)
  • just for 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)

Table of built distributions (wheels) for skope 0.0.1
File Interpreter ABI Platform
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}

Release history Release notifications | RSS feed

This release

0.0.1 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page