Deepvista Vistabase Card

DeepVista Card: Manage your knowledge cards — create, search, and organize context cards.

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)