> ## Documentation Index
> Fetch the complete documentation index at: https://fabric.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Fabric CLI

> Fabric, from your terminal. Search your library and save to it without leaving the shell. 

## 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:

```text theme={null}
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

| Options         | Description                         |
| --------------- | ----------------------------------- |
| `-V, --version` | Output version number               |
| `-h, --help`    | Display help for command            |
| `--json`        | Output JSON in non-interactive mode |

### 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.

| Command                    | Description                                                                                                                                                                                                                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `auth <api-key>`           | Store API key for authentication                                                                                                                                                                                                                                                                       |
| `login`                    | Login via browser                                                                                                                                                                                                                                                                                      |
| `logout`                   | Clear 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: <br />- \[URL] → bookmark <br />- \[File path] → upload<br />- \[Text] → note<br />- 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.<br />- `list` \[options] List tasks <br />- `add` \[options] \<title> Create a task <br />- `done` \[options] \<taskId> Mark a task as completed <br />- `edit` \[options] \<taskId> Edit a task <br />- `rm` \[options] \<taskId> Delete a task <br />- `help` Display help for command |
| `completion <shell>`       | Generate shell completion script: bash, zsh, or fish                                                                                                                                                                                                                                                   |
| `help [command]`           | Display help for \[command]                                                                                                                                                                                                                                                                            |
| `subscription`             | Displays information about your workspace's subscription plan, usage, and quotas                                                                                                                                                                                                                       |

### What are some usage examples?

| Example command                                                   | Outcome                                                                                                                      |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `fabric search meeting notes`                                     | Hybrid search current Fabric workspace for query "meeting notes"                                                             |
| `fabric search design --tag work`                                 | Hybrid search current Fabric workspace for query "design", filtering for the tag "work"                                      |
| `fabric search --tag reading,todo`                                | Hybrid search current Fabric workspace filtering for the tags "reading" and "todo"                                           |
| `fabric path My Space`                                            | Browse the folder at path: `Root` > `My Space`                                                                               |
| `fabric path Inbox/Reports`                                       | Browse the folder at path: `Root` > `Inbox` > `Reports`                                                                      |
| `fabric create note Meeting summary --tag work`                   | Create 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 client`                      | Create a folder called "Projects", with the tag "client"                                                                     |
| `fabric create folder Archive --parent "Work" --tag archive`      | Create 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](https://example.com)" and set title to "Article"                            |
| `fabric create file ~/Desktop/report.pdf`                         | Create a file from a local PDF at the path "\~/Desktop/report.pdf"                                                           |
| `fabric note "Quick reminder" --tag remember`                     | Create 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 reading` | Create a bookmark for URL "[https://example.com](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](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 reading`                   | Create a bookmark for URL "[https://example.com](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 personal`           | Create a note with the body "Remember to call dentist" with the tag "personal"                                               |
| `fabric task list`                                                | List all tasks in the workspace                                                                                              |
| `fabric task list --todo`                                         | List all pending tasks in the workspace                                                                                      |
| `fabric task list --done`                                         | List all completed tasks in the workspace                                                                                    |
| `fabric task add "Buy groceries" --due-date 2026-04-20`           | Create a task "Buy groceries" and set the due date to 2026-04-20                                                             |
| `fabric task add "Review PR" --priority HIGH`                     | Create 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 list`                                           | List your workspaces by name                                                                                                 |
| `fabric workspace current`                                        | Returns current workspace name                                                                                               |
| `fabric workspace select My Team`                                 | Switch to the workspace "My team"                                                                                            |
