VistaBase
PREREQUISITE: Read deepvista-shared for auth, profiles, and global flags.
VistaBase is DeepVista's knowledge base — a collection of context cards that represent people, organizations, topics, notes, files, and more. Cards have vector embeddings for semantic search and keyword indexing for precise lookups.
CRUD Commands
list
deepvista --profile local vistabase 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 --profile local vistabase get <card_id>create
deepvista --profile local vistabase create --type TYPE --title "Title" [--content "Description"] [--tags '["t1","t2"]'] [--no-enrich][!CAUTION] Write command — confirm with user before executing.
update
deepvista --profile local vistabase update <card_id> [--title "..."] [--content "..."] [--type TYPE] [--tags '["t1"]'] [--status pinned|archived][!CAUTION] Write command — confirm with user before executing.
delete
deepvista --profile local vistabase delete <card_id> [--type TYPE][!CAUTION] Destructive command — confirm with user before executing.
Helper Commands
+search
deepvista --profile local vistabase +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. Results include relevance scores from hybrid search (vector similarity + keyword matching). Use vistabase get <id> to read the full content of a result.
+similar
deepvista --profile local vistabase +similar <card_id> [--limit N]Find context cards semantically similar to a given card. Uses the source card's content as a search query.
| Flag | Required | Default | Description |
|---|---|---|---|
<card_id> | Yes | — | Source card to find similar cards for |
--limit | No | 5 | Max results |
Read-only. The source card is excluded from results. Useful for discovering related knowledge you may not have thought to search for.
+pin
deepvista --profile local vistabase +pin <card_id>[!CAUTION] Write command.
+archive
deepvista --profile local vistabase +archive <card_id>[!CAUTION] Write command.
Card Types
person, organization, message, todo, topic, keypoint, file, note, vistabook, vistabook_run
Examples
# Search for anything about quarterly metrics
deepvista --profile local vistabase +search "quarterly metrics"
# Find people related to a topic
deepvista --profile local vistabase +search "machine learning team" --type person
# Find cards similar to a specific card
deepvista --profile local vistabase +similar card_abc123 --limit 10
# List all people cards
deepvista --profile local vistabase list --type person
# Create a topic card
deepvista --profile local vistabase create --type topic --title "Machine Learning Strategy" --content "Our approach to ML..."
# Pin an important card
deepvista --profile local vistabase +pin abc123
# Get full details of a card
deepvista --profile local vistabase get abc123See Also
- deepvista-shared — Auth and global flags
- deepvista-notes — Notes (subset of vistabase)