Command line

Use the remember-cards CLI to create, update, and fetch cards from your terminal.

Install

Install the package from PyPI:

Install
uv tool install remember-cards

Authentication

Create an API key from your profile, then expose it as an environment variable:

Authentication
export REMEMBER_CARDS_API_KEY=rc_...

Command reference

Command Required inputs Optional inputs Output
remember-cards --help none none Show top-level help
remember-cards --version none none Show the installed CLI version
add --front TEXT, --back TEXT --tags TEXT New card ID and tag summary
fetch --tag TEXT none Matching cards as Markdown
update --id INTEGER and at least one changed field --front TEXT, --back TEXT, --tags TEXT Updated card ID and tag summary
list-tags none none Tags with card counts

Commands

Add a card

Add one flashcard to your account.

Input Required Description
--front TEXT yes Card front text
--back TEXT yes Card back text
--tags TEXT no Comma-separated tags

Add a card
remember-cards add \ --front "What is spaced repetition?" \ --back "A review schedule that expands over time." \ --tags "learning,memory"

Tags are comma-separated and normalized to lowercase.

Fetch cards by tag

Fetch cards matching one tag and print them as Markdown.

Input Required Description
--tag TEXT yes Tag name to filter cards by

Fetch cards
remember-cards fetch --tag learning

Cards are printed as Markdown blocks, which makes the output easy to save, pipe, or edit.

Update a card

Update an existing card by numeric ID. At least one of --front, --back, or --tags must be provided.

Input Required Description
--id INTEGER yes Card ID to update
--front TEXT no New card front text; omit to keep the current front
--back TEXT no New card back text; omit to keep the current back
--tags TEXT no New comma-separated tags; pass "" to clear, omit to keep current tags

Update a card
remember-cards update \ --id 42 \ --front "What is spaced repetition good for?" \ --back "Remembering information with less repeated effort."

Omit fields you want to keep unchanged. To replace all tags, pass a new comma-separated list:

Replace tags
remember-cards update --id 42 --tags "learning,anki"

To clear tags, pass an empty string:

Clear tags
remember-cards update --id 42 --tags ""

List tags

List every tag attached to your cards.

Input Required Description
none no This command has no command-specific inputs

List tags
remember-cards list-tags

This prints every tag attached to your cards, plus the number of cards for each tag.

Check the version

Show the installed CLI version.

Input Required Description
none no This command has no inputs

Version
remember-cards --version

See also

Prefer raw Markdown? View this page as .md