CLI

The Edicek CLI lets you work with your cards from the terminal - save a link or a note straight into your workspace, and export everything you have saved to Markdown files.

Install

Install the CLI globally with your package manager:

npm install -g edicek

pnpm add -g edicek

yarn global add edicek

Step by step tutorial

The CLI authenticates with a Personal access token - the same kind the API uses. Create one in the web app.

Personal access tokens can currently be created only in the web app at my.edicek.com - not in the mobile or desktop apps.

Open your Profile

In the web app, click your user icon and choose Profile from the menu.

Go to Personal Access Tokens

On the Profile page, find the Personal Access Tokens section.

Create a token

Click Create, give it a name, and copy the token value.

Run the export with it

Pass the token to --token:

npx edicek cards export --token <your-token>

Save a link

Run cards bookmark add with a URL to save it as a new card in your workspace. Add an optional note to capture WHY it matters:

npx edicek cards bookmark add --url https://example.com --note "Why I saved this" --token <your-token>

Option	Description	Default
`-u, --url <url>`	URL to save. Required.	N/A
`-n, --note <note>`	Optional note attached to the card.	N/A
`-t, --token <token>`	Your Personal access token. Required.	N/A
`-w, --workspace <id>`	ID of the workspace to save into.	First workspace

Page metadata is extracted on the server right after the card is created, so the title and description of a freshly saved link show up a moment later.

Save a note

Run cards note add with your text to save it as a new note card in your workspace. Pass the text directly, or read it from a file - the two options cannot be combined:

npx edicek cards note add --content "Something worth remembering" --token <your-token>
npx edicek cards note add --file ./notes/meeting.md --token <your-token>

Option	Description	Default
`-c, --content <content>`	Note content to save.	N/A
`-f, --file <path>`	Path to a file with the note content.	N/A
`-t, --token <token>`	Your Personal access token. Required.	N/A
`-w, --workspace <id>`	ID of the workspace to save into.	First workspace

Export your cards

Run cards export with a Personal access token:

npx edicek cards export --token <your-token>

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

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

What you get

What each .md file holds depends on the card’s type - see the supported card types for what each one captures. Here’s a saved TikTok video:

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

Getting started

Applications

Core features

Card types

Developers

Support

Install

Step by step tutorial

Save a link

Save a note

Export your cards

What you get

Next steps

API

Help & feedback

​Install

​Step by step tutorial

​Save a link

​Save a note

​Export your cards

​What you get

​Next steps

API

Help & feedback

Install

Step by step tutorial

Save a link

Save a note

Export your cards

What you get

Next steps