> 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
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.
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 |
deepvista card get <card_id>
deepvista card create --type TYPE --title "Title" [--content "Description"] [--tags '["t1","t2"]'] [--no-enrich]
> [!CAUTION] Write command — confirm with user before executing.
deepvista card update <card_id> [--title "..."] [--content "..."] [--type TYPE] [--tags '["t1"]'] [--status pinned|archived]
> [!CAUTION] Write command — confirm with user before executing.
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 |
|---|---|---|---|
| ------ | ---------- | --------- | ------------- |
| 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.
deepvista card delete <card_id> [--type TYPE]
> [!CAUTION] Destructive command — confirm with user before executing.
deepvista card +search "query text" [--type TYPE] [--limit N]
Search across all context cards using hybrid vector + keyword search.
| Flag | Required | Default | Description |
|---|---|---|---|
| ------ | ---------- | --------- | ------------- |
| Yes | — | Search query (natural language) |
--type | No | all | Filter by card type |
--limit | No | 10 | Max results |
Read-only. Use card get to read the full content of a result.
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.
deepvista card +pin <card_id>
> [!CAUTION] Write command.
deepvista card +archive <card_id>
> [!CAUTION] Write command.
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 |
|---|---|---|---|
| ------ | ---------- | --------- | ------------- |
| 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 to read the full content of a result.
person, organization, message, todo, topic, keypoint, file, note, recipe, recipe_run
# 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
共 1 个版本