WebCull - Documentation

Overview

WebCull CLI Is A Programmable Bookmark Interface

The WebCull CLI lets you, your scripts, and your agent tools inspect and update bookmarks from a terminal. It works best when you start with small results, choose only the fields you need, and make focused follow-up requests.

webcull <command> [options]

Start here

Install And Run The CLI

Install from npm, authorize WebCull, then run a small command. Agent skills are optional for guided agent workflows.

Install from npm

View on GitHub

1

Install Run npm install -g @webcull/cli.

2

Authorize Run webcull login, then compare the pairing code to authorize with your account.

3

Run a command Run commands like webcull whoami or webcull graph schema.

Command

webcull

Package

@webcull/cli

npm

npmjs.com/package/@webcull/cli

GitHub

github.com/webcull/webcull-cli

Default API

https://api.webcull.com

Config path

~/.config/webcull/config.json

Use Cases

Use The CLI When Bookmarks Become Data

Discovery

Search, count, and browse bookmark structures without opening the app.

Knowledge work

Inspect relationships between folders, bookmarks, competitors, projects, campaigns, and other saved work.

Automation

Create small scripts that read bookmark data, validate graph areas, or schedule reminders.

Agent workflows

Give agent tools a conservative command interface for broad discovery followed by focused detail checks.

Workflow

Start Broad, Then Narrow By ID

webcull whoami
webcull bookmarks count --path /
webcull bookmarks tree --path / --max-depth 1 --limit 25 --fields id,type,title
webcull bookmarks search --query 'pricing competitor' --limit 20 --fields id,title,url,parent_id
webcull bookmarks get --ids 2302 --fields id,title,url,notes

The normal pattern is to find likely IDs with a small command, then fetch details only for those IDs. This keeps responses fast and easier to review.

Initial Commands

Run These Commands First

These commands establish account access, show current limits, and inspect the account without requesting a large result. They are the safest starting point for humans, scripts, and agents.

webcull login
webcull whoami
webcull limits
webcull bookmarks count --path /
webcull bookmarks tree --path / --max-depth 1 --limit 25 --max-chars 8000 --fields id,type,title,modified

Command Map

Choose The Smallest Command That Answers The Question

login, whoami, limits

Authorize the CLI, verify the account, and check usage capacity.

bookmarks count, tree, get

Inspect placement and fetch specific bookmark records.

bookmarks search

Find bookmarks by terms, saved fields, and bookmark details.

graph around, backlinks, path

Inspect relationships around saved bookmarks and folders.

bookmarks create, update

Create or update one bookmark or folder when you ask for that write.

reminders create, list, cancel

Schedule, inspect, or cancel pending bookmark reminders.

Safety Model

The CLI Is Conservative By Default

Read commands support limits. Write commands are narrow. E2EE passphrases stay in hidden terminal prompts. Tokens live in operating system credential storage. Graph commands are read-only and exclude notes unless you request extra fields.