Skip to main content

What does the Fabric CLI let me do?

  • Control your Fabric account, add, edit, move, tag, delete content, tasks and more. Ask your Fabric AI assistant a question, or to do something – without leaving the terminal. Almost all Fabric capabilities are exposed via the CLI.
  • Allow an agent (e.g. Claude Code or OpenClaw) to use your Fabric or Fabric Memory.

Who can use the CLI?

The CLI is available on all plans.

Where do I get the CLI?

In your terminal, run:
curl -fsSL https://fabric.so/cli/install.sh | sh
This will install the Fabric CLI.

How can I use the CLI?

Usage: fabric [options] [command]\

Options

OptionsDescription
-V, --versionOutput version number
-h, --helpDisplay help for command

Commands

The note, link, and file commands are shortcuts for their create equivalents. Use create when you want explicit control; use the shortcuts for faster, minimal input. save is a smart command – it detects the content type automatically, so you don’t have to specify it at all.
CommandDescription
auth <api-key>Store API key for authentication
loginLogin via browser
logoutClear stored credentials
search [options] [query]Search your Fabric
path [options] [query]Browse items. No arg will list root spaces
create [options] <kind>Create a resource: space, folder, note, link, or file
note [options] [content]Create a note. Reads content from stdin if not provided.
link [options] <url>Save a bookmark
file [options] <path>Upload a local file
save [options] [input]Smart save, automatically creates appropriate resource type based on provided content:
- [URL] → bookmark
- [File path] → upload
- [Text] → note
- Reads from stdin if no input given
folder [options] [name]Create a folder in Inbox (or specify --parent or / for root, or a name path)
inbox [options]List items in Inbox
bin [options]List items in Bin
workspace [action]List, choose, or see workspace(s) [list, select, current]
ask [options] [question]Ask your Fabric AI assistant a question or to do something
task [action]Manage tasks.
- list [options] List tasks
- add [options] <title> Create a task
- done [options] <taskId> Mark a task as completed
- edit [options] <taskId> Edit a task
- rm [options] <taskId> Delete a task
- help Display help for command
completion <shell>Generate shell completion script: bash, zsh, or fish
help [command]Display help for [command]
subscriptionDisplays information about your workspace’s subscription plan, usage, and quotas

What are some usage examples?

Example commandOutcome
fabric search meeting notesHybrid search current Fabric workspace for query “meeting notes”
fabric search design --tag workHybrid search current Fabric workspace for query “design”, filtering for the tag “work”
fabric search --tag reading,todoHybrid search current Fabric workspace filtering for the tags “reading” and “todo”
fabric path My SpaceBrowse the folder at path: Root > My Space
fabric path Inbox/ReportsBrowse the folder at path: Root > Inbox > Reports
fabric create note Meeting summary --tag workCreate a note in Inbox, with a body of “Meeting summary”, and with the tag “work”
fabric create note "Q1 Review" --parent "Work/Projects"Create a note in /Work/Projects, with a body of “Q1 Review”
fabric create folder Projects --tag clientCreate a folder called “Projects”, with the tag “client”
fabric create folder Archive --parent "Work" --tag archiveCreate a folder called “Archive” inside the folder “Work”, with the tag “archive”
fabric create folder "My Space" --parent /Create a folder called “My Space” at the workspace root (/)
fabric create link https://example.com --title "Article"Create a bookmark for URL “https://example.com” and set title to “Article”
fabric create file ~/Desktop/report.pdfCreate a file from a local PDF at the path ”~/Desktop/report.pdf”
fabric note "Quick reminder" --tag rememberCreate a note with the body “Quick reminder” with the tag “remember”
fabric note "Ideas" --parent "Work/Projects"Create a note with the body “Ideas” inside the folder “Work”, inside the folder “Projects”
fabric link https://example.com --title "Article" --tag readingCreate a bookmark for URL “https://example.com”, set title to “Article”, and set the tag “reading”
fabric link https://example.com --parent "Work/Reading"Create a bookmark for URL “https://example.com” inside the folder “Work”, inside the folder “Reading”
fabric file ~/Downloads/report.pdf --title "Q4 Report"Create a file from a local PDF at the path ”~/Downloads/report.pdf” and set the title to “Q4 Report”
fabric file ~/Downloads/report.pdf --parent "Work/Reports"Create a file from a local PDF at the path ”~/Downloads/report.pdf” inside the folder “Work”, inside the folder “Reports”
fabric save https://example.com --tag readingCreate a bookmark for URL “https://example.com”, with the tag “reading”
fabric save ~/Downloads/doc.pdf --title "Report"Create a file from a local PDF at the path ”~/Downloads/doc.pdf” and set the title to “Report”
fabric save "Remember to call dentist" --tag personalCreate a note with the body “Remember to call dentist” with the tag “personal”
fabric task listList all tasks in the workspace
fabric task list --todoList all pending tasks in the workspace
fabric task list --doneList all completed tasks in the workspace
fabric task add "Buy groceries" --due-date 2026-04-20Create a task “Buy groceries” and set the due date to 2026-04-20
fabric task add "Review PR" --priority HIGHCreate a task “Review PR” and set the priority to “HIGH”
fabric task done <taskId>Mark a specific task as done
fabric task edit <taskId> --title "New title"Edit a specific task by setting the name to “New title”
fabric task rm <taskId>Delete a specific task
fabric workspace listList your workspaces by name
fabric workspace currentReturns current workspace name
fabric workspace select My TeamSwitch to the workspace “My team”