screenkite
v0.1.2
Published
Read ScreenKite AI-context shares: transcript, click context, video, and frames.
Readme
screenkite
CLI for ScreenKite. An agent can read a shared recording and, on macOS, edit a project in the installed app.
npx screenkite@latest share context https://www.screenkite.com/en/share/<uuid>The first 100 anonymous requests need no account. Run npx screenkite login
for unlimited fair use.
Install
npm install -g screenkite
# or
npx screenkite@latest --helpThe npm package ships macOS binaries for arm64 and x64 in one tarball. Other
platforms print dependency_missing.
Commands
screenkite login [--device] [--no-wait] [--json]
screenkite login status|cancel [--attempt <id>]
screenkite logout
screenkite whoami
screenkite doctor
screenkite share info|context|events|transcript <url|uuid> [--json]
screenkite share video <url> [--out <dir>] [--json]
screenkite share frames <url> --at 7.2,16.0 [--out <dir>] [--json]
screenkite mcp [--project <path> | --mcp-port <n>] [--no-native] [--native-only]
screenkite native-help
screenkite setup <claude|codex|cursor|antigravity> [--skill-only]These words forward to the installed macOS app:
screenkite workspace …
screenkite project …
screenkite sessions …
screenkite skills …
screenkite transcription …
screenkite recover …
screenkite tool …Run screenkite native-help for the native usage text. Native forwarding is macOS
only. Other platforms print a dependency_missing error.
Every owned command accepts --json. Errors go to stderr as
{"error":{"code","message","next"}}.
| Exit | Meaning | | --- | --- | | 0 | Success | | 2 | Usage | | 3 | Login required | | 4 | Share not found or not AI-readable | | 5 | Validation or missing dependency (ffmpeg or the macOS app) | | 6 | Server, network, or sidecar mismatch | | 7 | Quota exhausted |
Auth
- Loopback OAuth (PKCE S256 + state) on
127.0.0.1. - Device code (
--device, or automatic when there is no TTY,SSH_CONNECTION/SSH_TTY, or a non-mac host withoutDISPLAY). SCREENKITE_TOKEN— used exclusively when set.
Credentials: ~/.screenkite/credentials.json (mode 0600; Windows ACL via icacls).
Device id: ~/.screenkite/device.json.
Bearer tokens are sent only to https://agent.screenkite.com. Redirects to
cloud/proxy URLs strip Authorization.
Agent setup
npx screenkite@latest setup claude
npx screenkite@latest setup codex
npx screenkite@latest setup cursor
npx screenkite@latest setup antigravityLocal build
cd apps/screenkite-cli
bun install
bun test
bun run build --host
./dist/<host-target>/screenkite --versionRun bun run build on macOS to compile the npm release set (darwin-arm64 and
darwin-x64). Darwin binaries are ad-hoc signed and verified with codesign.
Linux and Windows hosts can build a local binary with --host or an explicit
target name.
