Quickstart

Homebrew and GitHub Releases distribution are being prepared. Until they are available, build and install Zanei from source:

git clone https://github.com/KentoShimizu/zanei.git
cd zanei
cargo build --release
mkdir -p "$HOME/.cargo/bin"
install -m 755 target/release/zanei "$HOME/.cargo/bin/zanei"

Make sure $HOME/.cargo/bin is on your PATH.

Zanei doesn’t record your screen. Instead, depending on what you capture, it needs macOS permissions (Accessibility, Input Monitoring, Automation). Start with a diagnosis:

zanei doctor

If anything is missing, you’ll see what is needed, why, and how to grant it. Add --fix to open the relevant System Settings pane directly:

zanei doctor --fix

zanei start

Recording starts in the background as a launchd agent. You can check on it at any time:

zanei status

Work normally for a bit, then pull up your recent history:

zanei timeline --since 15m

You get a session-structured, deduplicated Markdown timeline — the same form agents consume. For raw events, use zanei query --since 15m instead (see retrieving data).

Place the skill file for your agent and print its MCP registration command:

zanei setup --agent claude

From now on, telling your agent “check what I was just working on and continue” lets it restore context from the timeline. See agent integration for supported agents and details.