Card (Knowledge Base)
PREREQUISITE: Read deepvista-shared for auth, profiles, and global flags.
Cards are DeepVista's knowledge base — context cards representing people, organizations, topics, notes, files, and more. Cards have vector embeddings for semantic search and keyword indexing for precise lookups.
Command: deepvista card <subcommand>
App URLs
After any write operation (create, update), always show the card URL to the user:
https://app.deepvista.ai/vistabase?contextId=<id>
Extract the id from the JSON response and present it as a clickable link.
CRUD Commands
list
deepvista card list [--type TYPE] [--status STATUS] [--limit N] [--page N] [--order-by FIELD] [--order DIR]
| Flag | Required | Default | Description |
|---|---|---|---|
--type |
No | all | Card type filter |
--status |
No | all | pinned, archived, or normal |
--limit |
No | 20 | Max results |
--page |
No | 1 | Page number |
--order-by |
No | — | created_at or updated_at |
--order |
No | — | asc or desc |
get
deepvista card get <card_id>
create
deepvista card create --type TYPE --title "Title" [--content "Description"] [--tags '["t1","t2"]'] [--no-enrich]
[!CAUTION] Write command — confirm with user before executing.
update
deepvista card update <card_id> [--title "..."] [--content "..."] [--type TYPE] [--tags '["t1"]'] [--status pinned|archived]
[!CAUTION] Write command — confirm with user before executing.
edit
deepvista card edit <card_id> --old-string "text to find" --new-string "replacement" [--replace-all]
Targeted string replacement in a card's content — like Claude Code's Edit tool. Finds old_string in the card description and replaces it with new_string. By default, old_string must appear exactly once (provide more surrounding context to disambiguate).
| Flag | Required | Default | Description |
|---|---|---|---|
<card_id> |
Yes | — | Card to edit |
--old-string |
Yes | — | Exact text to find |
--new-string |
Yes | — | Replacement text |
--replace-all |
No | false | Replace all occurrences |
[!CAUTION] Write command — confirm with user before executing.
delete
deepvista card delete <card_id> [--type TYPE]
[!CAUTION] Destructive command — confirm with user before executing.
Helper Commands
+search
deepvista card +search "query text" [--type TYPE] [--limit N]
Search across all context cards using hybrid vector + keyword search.
| Flag | Required | Default | Description |
|---|---|---|---|
<query> |
Yes | — | Search query (natural language) |
--type |
No | all | Filter by card type |
--limit |
No | 10 | Max results |
Read-only. Use card get <id> to read the full content of a result.
+similar
deepvista card +similar <card_id> [--limit N]
Find context cards semantically similar to a given card.
Read-only. The source card is excluded from results.
+pin
deepvista card +pin <card_id>
[!CAUTION] Write command.
+archive
deepvista card +archive <card_id>
[!CAUTION] Write command.
+grep
deepvista card +grep "pattern" [--type TYPE] [-i] [--limit N] [-C N]
Regex search through card content. Returns matching lines with line numbers — like grep or ripgrep. Different from +search (semantic/keyword): this does literal/regex matching on card content.
| Flag | Required | Default | Description |
|---|---|---|---|
<pattern> |
Yes | — | Regex pattern to search for |
--type |
No | all | Filter by card type |
-i / --ignore-case |
No | false | Case-insensitive matching |
--limit |
No | 20 | Max cards to return |
-C / --context |
No | 0 | Lines of context around each match |
Read-only. Use card get <id> to read the full content of a result.
Card Types
person, organization, message, todo, topic, keypoint, file, note, recipe, recipe_run
Examples
# Search for anything about quarterly metrics
deepvista card +search "quarterly metrics"
# Find people related to a topic
deepvista card +search "machine learning team" --type person
# Grep for a specific pattern in card content
deepvista card +grep "TODO|FIXME" --type note -i
# Grep with context lines
deepvista card +grep "API endpoint" -C 2
# List all notes
deepvista card list --type note
# Create a topic card
deepvista card create --type topic --title "Machine Learning Strategy" --content "Our approach to ML..."
# Edit a card's content (targeted replacement)
deepvista card edit abc123 --old-string "old API URL" --new-string "new API URL"
# Pin an important card
deepvista card +pin abc123
# Get full details of a card
deepvista card get abc123
See Also
- deepvista-shared — Auth and global flags
- deepvista-notes — Notes (shorthand for cards with type=note)