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

# Find & organise

> Works on any item. The id says what it is: pag_ note, cnv_ canvas, prj_ project, ntb_ notebook.

```bash theme={null}
octonote list --kind canvas
octonote search onboarding
octonote rename cnv_… "Login flow v2"
octonote move pag_… --notebook "Archive"
octonote delete cnv_… --yes
```

## list

List notes, canvases, projects and notebooks (newest first). Alias: `ls`.

```bash theme={null}
octonote list [options]
```

| Argument or option | What it does |
| - | - |
| `-k, --kind <kind>` | only this kind: note \| canvas \| project \| notebook |
| `-n, --notebook <notebook>` | only what's inside this notebook (id or exact name) |

## search

Find notes, canvases, projects and notebooks by title

```bash theme={null}
octonote search <query…>
```

| Argument or option | What it does |
| - | - |
| `<query>` | words to look for in titles (required) |

## open

Print the app link for an item (and open it when run in a terminal)

```bash theme={null}
octonote open <id>
```

| Argument or option | What it does |
| - | - |
| `<id>` | any Octonote id or URL (required) |

## move

Move a note, canvas or project into a notebook (or out with --out)

```bash theme={null}
octonote move <id> [options]
```

| Argument or option | What it does |
| - | - |
| `<id>` | note, canvas or project id (required) |
| `-n, --notebook <notebook>` | target notebook (id or exact name) |
| `--out` | take it out of its notebook |

## rename

Rename a note, canvas, project or notebook

```bash theme={null}
octonote rename <id> <name>
```

| Argument or option | What it does |
| - | - |
| `<id>` | any Octonote id (required) |
| `<name>` | new name (required) |

## delete

Delete a note, canvas, project or notebook (a notebook's contents move to the top level). Alias: `rm`.

```bash theme={null}
octonote delete <id> [options]
```

| Argument or option | What it does |
| - | - |
| `<id>` | any Octonote id (required) |
| `-y, --yes` | required: confirms the delete (agents: only when the user asked) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.