@airjelly/cli

⚠️ Install only from the official scope: @airjelly/cli. Any airjelly-cli (without scope) is not published by us.

Command-line client for AirJelly — query memories, tasks, events, and app usage from the terminal. Everything stays on 127.0.0.1; no data leaves your machine.

Note: Some commands require a recent AirJelly Desktop version. Older desktops (e.g. v1.0.0) expose a subset. Run airjelly capabilities to see what your desktop supports.

Install

npm i -g @airjelly/cli

Requires Node 18+ and the AirJelly Desktop app running.

Quick start

airjelly status                              # connection check
airjelly task open                           # your open tasks
airjelly memory search "project meeting"     # semantic search
airjelly apps today                          # today's app usage
airjelly ui                                  # open local web console

Every command supports --json for piping into jq / scripts:

airjelly task open --json | jq '.[].title'

Commands

| Group | What it does | |---|---| | airjelly status | Connection check | | airjelly capabilities | List methods your AirJelly exposes | | airjelly memory … | Search, list, and fetch memories + people entities | | airjelly task … | Read, create, update, complete, snooze, archive tasks | | airjelly apps … | App usage today / range / top / sessions | | airjelly reminder … | Dismiss / snooze reminders | | airjelly recording … | Screen recording status, permissions, stats | | airjelly ui | Launch a local web console for memories, tasks, and app usage |

Run any command with --help for its flags, e.g. airjelly memory search --help.

Authentication

AirJelly Desktop writes a runtime.json on startup with a random port and bearer token (chmod 600). The CLI reads it automatically — no configuration needed. The token is regenerated on every AirJelly restart.

Troubleshooting

| Error | Fix | |---|---| | ✗ AirJelly is not running | Open the AirJelly Desktop app | | ✗ Cannot connect to AirJelly | Restart AirJelly Desktop | | ✗ Method not found: xxx | The method isn't exposed by your AirJelly version. Run airjelly capabilities to see what's available, or upgrade AirJelly Desktop | | ✗ AirJelly protocol version mismatch | Upgrade the side that's older (CLI or Desktop) |

Security

• Server binds to 127.0.0.1 only — never network-reachable.
• Auth via bearer token in runtime.json (chmod 600), regenerated on every AirJelly restart.
• Any local process running as your OS user can read runtime.json. Only install CLI wrappers from trusted sources.
• The public API does not expose shell or file-system access to external clients.
• LLM-cost commands (memory search, task create) trigger server-side LLM / embedding calls and consume your AirJelly credits.

Report security issues privately to [email protected].

Support

Questions or bug reports: [email protected]

This package is distributed as a compiled binary. Source code is not public.