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

# CLI

The Edicek CLI exports your saved cards to Markdown files on your machine - ready to read, grep, or feed into other tools and AI agents. It does one thing: `export`.

## Install

Install the CLI globally with your package manager:

<CodeGroup>
  ```bash npm theme={null}
  npm install -g edicek
  ```

  ```bash pnpm theme={null}
  pnpm add -g edicek
  ```

  ```bash yarn theme={null}
  yarn global add edicek
  ```
</CodeGroup>

## Options

| Option                 | Description                                 | Default         |
| ---------------------- | ------------------------------------------- | --------------- |
| `-t, --token <token>`  | Your Personal access token. **Required.**   | N/A             |
| `-o, --output <path>`  | Directory to write the Markdown files into. | `./.edicek`     |
| `-w, --workspace <id>` | ID of the workspace to export.              | First workspace |

## Export your cards

Run `export` with a Personal access token:

```bash theme={null}
npx edicek export --token <your-token>
```

This pulls the cards in your workspace and writes each one as a Markdown file into a local `./.edicek` folder, along with a `README`.

```
.edicek/
├── README.md
├── 2026-02-14-cmb5ks86.md
├── 2026-02-15-cmb7ht42.md
├── 2026-02-16-cmb9xr10.md
├── 2026-02-18-cmbd2p94.md
└── {date}-{cardId}.md
```

## Step by step tutorial

The CLI authenticates with a **Personal access token** - the same kind the [API](/developers/api) uses. Create one in the web app.

<Note>Personal access tokens can currently be created only in the **web app** at [my.edicek.com](https://my.edicek.com) - not in the mobile or desktop apps.</Note>

<Steps>
  <Step title="Open your Profile">
    Click your user icon and choose `Profile` from the menu.
  </Step>

  <Step title="Go to Personal Access Tokens">
    On the Profile page, find the **Personal Access Tokens** section.
  </Step>

  <Step title="Create a token">
    Click `Create`, give it a name, and copy the token value.
  </Step>

  <Step title="Run the export with it">
    Pass the token to `--token`:

    ```bash theme={null}
    npx edicek export --token <your-token>
    ```
  </Step>
</Steps>

## What you get

What each `.md` file holds depends on the card's type - see the [supported card types](/core-features/cards#supported-card-types) for what each one captures. Here's a saved TikTok video:

````markdown theme={null}
<!--
This markdown was exported from Edicek (https://www.edicek.com),
a personal knowledge management tool. Use this content in your
favorite AI tools, note-taking apps, or anywhere else you need it.
-->

==================
Metadata
==================

- **Created:** 2026-07-15T06:50:16.594+00:00

- **Exported:** 2026-07-15T06:50:21.180+00:00

===================
User Note
===================

<!-- This is a personal note written by the user explaining why this content is relevant to them, what they want to remember, or how they plan to use it. -->

```
I'd love to try this if I ever make it to Tokyo - making my own chopsticks.
```

========================
Saved Bookmark
========================

<!-- Automatically extracted metadata from the saved URL -->

- **URL:** https://www.tiktok.com/@travelcreator/video/7411882093451270345

- **Page Description:**

```
One of the cheapest things we did in Japan turned out to be one of our favorite memories. For just $3, we got to make our own chopsticks and leave with a souvenir we'll actually use for years. #Japan #Kyoto #Chopsticks
```

==========================
Video Transcript
==========================

<!-- Extracted transcript for video. Timestamps are in HH:MM:SS format. -->

00:00:10 A really big part of, like, what makes up, like, job.
00:00:18 Okay, we pick two to our station.
00:00:50 I'm gonna oil my chopstick, rub it together like a hand sanitizer.
00:01:02 Oh, we got our chopstick.
...
````

## Next steps

<Columns cols={2}>
  <Card title="API" icon="code" href="/developers/api">
    Full programmatic read and write access to your workspace.
  </Card>

  <Card title="Help & feedback" icon="life-ring" href="/support/support">
    Stuck on something with the CLI? Reach out - we're happy to help.
  </Card>
</Columns>