Search & Navigation

Finding cards quickly becomes essential as your project grows. Codecks search does double duty: it filters the cards you’re viewing and lets you jump directly to any card or deck in your workspace. You can open it by pressing / anywhere in the app or by clicking the search field in the top navigation bar.

How Search Works

When you type in the search field, Codecks suggests matching filters based on what you’re typing. Select a suggestion and it becomes an active filter, appearing as a pill below the search bar. These filters narrow down which cards are displayed in your current view.

You can stack multiple filters to create precise queries. For example, you might filter for cards assigned to you, with high priority, in the current run - all at once.

Filter Categories

Filtering by Users

Type @ followed by a name to see user-related filters:

• Owner - Find cards assigned to a specific person. You can also select “no owner” to find unassigned cards.
• Creator - Find cards created by a specific person.
• Mentioned - Find cards where someone is mentioned in conversations.
• Bookmarked by - Find cards that a specific user has bookmarked.

Filtering by Tags

Type # followed by the tag name to filter by tags. Codecks recognizes three types of tags:

• Project Tags - Tags managed by admins, often with colors or emojis for visual distinction.
• Personal Tags - Your own private tags that only you can see.
• Inline Tags - Tags written directly in card text using #tagname.

When you filter by multiple tags, you can choose how they combine. By default, cards must match all selected tags (AND logic). But when multiple tag filters are active, an “or” pill appears - click it to switch to OR logic, showing cards that have any of the selected tags.

Filtering by Status

You can filter cards by their workflow state:

• unassigned - Cards without an owner
• assigned - Cards with an owner but not yet started
• started - Cards currently being worked on
• snoozing - Cards that went quiet for too long
• blocked - Cards waiting on something
• review - Cards ready for feedback
• done - Completed cards
• archived - Archived cards (also enables the archive toggle automatically)
• undone - A handy filter for all cards not marked as done

Filtering by Card Type

Quickly narrow down to specific kinds of cards:

• hero - Hero Cards only
• subcard - Sub Cards (cards that belong to a Hero Card)
• doc - Doc Cards
• private - Private Ghost Cards
• locked / not locked - Cards with or without the locked flag
• coverImage - Cards that have a cover image set
• beast - Beast Cards (cards that have overstayed their welcome in a Run)

Filtering by Priority and Effort

When filtering by priority or effort, you can use comparison operators for more flexibility:

• Select a single value for an exact match
• A+ means priority A or higher (i.e., A and above)
• C- means priority C or lower

This is particularly useful when you want to find “all high priority cards” rather than just cards at one specific level.

Filtering by Location

Deck, Project, and Space

You can filter to show only cards from a specific deck, project, or Space. Selecting “no decks” shows Ghost Cards that haven’t been placed in any deck yet.

Zone

If you’re using Manual order with Zones, you can filter by specific zones.

Filtering by Run

Runs have several specialized filters that help with sprint planning:

• Specific Run - Cards assigned to a particular Run
• Current Run - Cards in whatever Run is currently active
• Future Run - Cards scheduled for upcoming Runs
• Past Run - Cards from Runs that have already ended
• Not in Run - Cards that haven’t been scheduled for any Run

Filtering by Milestone

Filter by a specific Milestone or select “no milestone” to find cards that haven’t been assigned to any milestone.

Filtering by Hand Status

• hand - Cards currently in your Hand
• notHand - Cards not in your Hand

Filtering by Due Date

• dueNow - Cards due today
• soon - Cards due within the next 7 days
• due - Any card that has a due date set

Filtering by Upvotes

For cards created through community feedback (like Discord integration), you can filter by upvote thresholds: 5+, 10+, 25+, or 50+ upvotes.

Searching Card Content

Title Search

Type t: followed by your search term to search specifically in card titles:

t:player movement

Full Text Search

Simply type any text without a special trigger to search across card content. This performs a full-text search through card descriptions.

Finding Sub Cards

Type sub: followed by a card reference or title to find all sub cards of a specific Hero Card.

Navigation Commands

Beyond filtering, search provides powerful navigation commands that take you directly to cards and decks. These are especially useful once you get comfortable with them - they’re faster than clicking through the UI.

Jump to Card by ID

Every card in Codecks has a unique ID displayed as a short code like $ABCD (you’ll see it on mini cards and in the card header). Type $ followed by the code to jump directly to that card:

$CODE

This is the fastest way to open a specific card when someone shares a card ID with you or when you’ve noted one down.

Jump to Deck

Type gd: (short for “go to deck”) followed by a deck name to navigate directly to that deck:

gd:backlog

This searches decks within your currently visible projects. If you need to find a deck in a hidden project, use gad: (“go to any deck”) instead:

gad:archive

Jump to Card by Title

Type gc: (“go to card”) to search for cards by title and jump directly to one:

gc:main menu redesign

For searching across all projects including hidden ones, use gac: (“go to any card”).

Combining Multiple Filters

Filters from different categories combine with AND logic by default. For example, if you select an owner and a priority and a status, you’ll see cards matching all three criteria.

For certain categories - tags, titles, and content searches - adding multiple filters from the same category shows an “or” pill. Click it to toggle between AND and OR logic for those specific filters.

Including Archived Cards

By default, archived cards are hidden from search results to reduce clutter. To include them, look for the “Archive” toggle in the search area and enable it.

When you filter specifically for archived status, this toggle is enabled automatically.

Contextual Search

Search behaves slightly differently depending on where you are in the app:

• In a Deck - Filters apply only to cards in that deck
• In a Milestone - Filters apply to cards in that milestone
• In a Run - Filters apply to cards in that run
• In the Hand tab - Filters apply across all your visible projects

You don’t need to manually add a deck filter when you’re already viewing a specific deck - the context is implicit.

Quick Reference

Keyboard Shortcuts