Cubox Guide

# Cubox CLI

Cubox CLI is Cubox’s official command-line interface.

With a single setup flow, you can authorize an AI agent to read or act on your Cubox library.

CLI capabilities span the full Cubox workflow: save, read, search, and organize—so your personal reading memory can actually be used in daily work.

# Install and sign in

Copy the prompt below and send it to your AI assistant (for example Claude Code, Codex, Cursor, Trae). It will help you install and configure everything.

Install Cubox CLI and its Skills:
https://github.com/OLCUBO/cubox-cli

During setup you will be asked for an API key. Copy it from the Cubox client or web: Settings → Extensions → API extension (open in browser (opens new window)).

# How you use it

After configuration, keep asking your agent for Cubox-related tasks—it will call the right tools.

From simple lookups to multi-step workflows, Cubox CLI with agents can feel like a real assistant that understands context.

# Basics

Save: batch-save links—for example URLs the agent just found for you.

Search: filter by folder, tag, star, read state, annotations, time saved, keywords; supports semantic (RAG) search.

Read content: fetch parsed Markdown, author metadata, and Cubox AI summaries for articles.

Read annotations: fetch highlights and notes, filter by color, keyword, or time—great for review and writing.

Structure: list folder and tag hierarchies.

Edit & organize: change star/read/archive, move between folders, apply tags, edit titles and descriptions.

# Example prompts

See the Cubox CLI GitHub README (opens new window) for details. Examples:

  • Save these links you just found into my Cubox folder “Learning”.
  • Find articles I saved last week about Apple’s early days and post a summary to my team chat.
  • Mark everything I saved three months ago that I still have not read as read.
  • Summarize my unread Cubox from the last week and archive what looks low value.
  • I’m writing about AI in education—pull good references from Cubox with original and Cubox links.
  • Move recently read, uncategorized items from the last month into sensible folders.
  • Tag everything related to “consumer” with industry tags.
  • What interesting connections show up in what I read lately?
  • What themes keep showing up in my recent annotations—what angle might I be missing?

# Upgrades

When a new Cubox CLI is available, the agent will prompt you; confirm to upgrade.

For the latest usage, follow the project on GitHub: Cubox CLI (opens new window).

← Save to Cubox →