@webcull/cli is the official command line client for WebCull bookmark access.
It is designed for humans, scripts, and coding agents that need conservative
read and focused write access to a subscribed WebCull account.
npm install -g @webcull/cliThe package requires Node.js 18 or newer.
webcull loginLogin starts a browser approval flow. The terminal shows a pairing code and the browser approval page shows the same code. Compare the codes before approving.
CLI tokens are separate from browser, extension, and app sessions. Tokens are stored in OS credential storage when available. The local config file may store non-secret metadata only.
webcull whoami
webcull limits
webcull bookmarks count
webcull bookmarks tree --depth 2 --limit 50
webcull bookmarks search "design systems" --limit 20
webcull bookmarks get 123 --fields id,title,value,tags
webcull reminders list --limit 20
webcull graph around --stack-id 123
webcull graph schemaRun commands with --format json when the output is being consumed by a script
or agent.
The CLI performs end-to-end encryption work locally. It must never send an E2EE passphrase, passphrase hash, derived key, or decrypted check value to WebCull.
The CLI rejects passphrase-style command line flags and environment variables. When encrypted fields are needed, it prompts interactively with hidden terminal input.
The CLI connects to your WebCull account through the WebCull API. Commands use the same account permissions and subscription status as the WebCull service.
If your account needs a subscription or account update, complete that in the WebCull app, then run the CLI command again.
Use of this CLI requires an active WebCull subscription. The source is available
so subscribers can inspect it, fork it, and adapt it for their own WebCull
workflows under the license terms in LICENSE.md.
npm test
npm run check
npm pack --dry-runBefore publishing, inspect npm pack --dry-run and confirm that the package
contains only the intended release files.