DeepVista Card: Manage your knowledge cards — create, search, and organize context cards.
---
name: deepvista-vistabase-card
description: "DeepVista Card: Manage your knowledge cards — create, search, and organize context cards."
metadata:
openclaw:
category: service
requires:
bins:
- deepvista
skills:
- deepvista-shared
install:
- kind: uv
package: deepvista-cli
bins: [deepvista]
homepage: https://cli.deepvista.ai
cliHelp: "deepvista card --help"
---
# Card (Knowledge Base)
> **PREREQUISITE:** Read [deepvista-shared](../deepvista-shared/SKILL.md) 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
```bash
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
```bash
deepvista card get <card_id>
```
### create
```bash
deepvista card create --type TYPE --title "Title" [--content "Description"] [--tags '["t1","t2"]'] [--no-enrich]
```
> [!CAUTION] Write command — confirm with user before executing.
### update
```bash
deepvista card update <card_id> [--title "..."] [--content "..."] [--type TYPE] [--tags '["t1"]'] [--status pinned|archived]
```
> [!CAUTION] Write command — confirm with user before executing.
### edit
```bash
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
```bash
deepvista card delete <card_id> [--type TYPE]
```
> [!CAUTION] Destructive command — confirm with user before executing.
## Helper Commands
### +search
```bash
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
```bash
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
```bash
deepvista card +pin <card_id>
```
> [!CAUTION] Write command.
### +archive
```bash
deepvista card +archive <card_id>
```
> [!CAUTION] Write command.
### +grep
```bash
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
```bash
# 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](../deepvista-shared/SKILL.md) — Auth and global flags
- [deepvista-notes](../deepvista-notes/SKILL.md) — Notes (shorthand for cards with type=note)
don't have the plugin yet? install it then click "run inline in claude" again.
added explicit inputs covering deepvista cli setup and card data formats, expanded 12-step procedure with full input/output contracts for each command, documented 8 decision points including write confirmations and error handling, specified json output schemas and http urls, clarified outcome signals for user feedback at each operation.
manage knowledge cards in deepvista's vistabase using CRUD operations, search, and organizational tools. use this skill when you need to create new context cards for people, organizations, topics, notes, files, or other entities; search across your existing knowledge base with vector and keyword indexing; update or delete cards; or organize cards with pins and archives. cards have semantic embeddings for fuzzy search and regex support for precise content matching.
prerequisite: read deepvista-shared for auth, profiles, and global flags.
uv install deepvista-cli. check install with deepvista card --help.list cards: run deepvista card list [--type TYPE] [--status STATUS] [--limit N] [--page N] [--order-by FIELD] [--order DIR]. inputs: optional type (person, organization, message, todo, topic, keypoint, file, note, recipe, recipe_run), optional status (pinned, archived, normal), optional limit (default 20), optional page (default 1), optional order-by (created_at or updated_at), optional order direction (asc or desc). outputs: JSON array of card summaries with id, title, type, status, created_at, updated_at.
get single card: run deepvista card get <card_id>. inputs: card id. outputs: full card JSON including id, title, type, content, tags, status, embeddings metadata, timestamps.
create card: run deepvista card create --type TYPE --title "Title" [--content "Description"] [--tags '["t1","t2"]'] [--no-enrich]. inputs: type (required, one of: person, organization, message, todo, topic, keypoint, file, note, recipe, recipe_run), title (required), content (optional description), tags (optional JSON array of strings), no-enrich flag (optional, skips semantic enrichment). outputs: created card JSON with assigned id. caution: write operation, confirm with user before executing.
update card: run deepvista card update <card_id> [--title "..."] [--content "..."] [--type TYPE] [--tags '["t1"]'] [--status pinned|archived|normal]. inputs: card id, zero or more of: new title, new content, new type, new tags array, new status. outputs: updated card JSON. caution: write operation, confirm with user before executing.
edit card content (targeted replacement): run deepvista card edit <card_id> --old-string "text to find" --new-string "replacement" [--replace-all]. inputs: card id, exact text to find (old-string), replacement text (new-string), optional replace-all flag to replace all occurrences instead of requiring exactly one match. outputs: updated card JSON showing modified content. caution: write operation, confirm with user before executing.
delete card: run deepvista card delete <card_id> [--type TYPE]. inputs: card id, optional type filter as safety check. outputs: confirmation message and deleted card id. caution: destructive operation, confirm with user before executing.
search cards (hybrid): run deepvista card +search "query text" [--type TYPE] [--limit N]. inputs: query string (natural language, required), optional type filter, optional limit (default 10). outputs: JSON array of matching cards with relevance scores, ordered by relevance. uses both vector embeddings and keyword indexing. read-only.
find similar cards: run deepvista card +similar <card_id> [--limit N]. inputs: source card id, optional limit. outputs: JSON array of semantically similar cards ordered by similarity score. source card is excluded. read-only.
pin card: run deepvista card +pin <card_id>. inputs: card id. outputs: updated card JSON with status set to pinned. caution: write operation.
archive card: run deepvista card +archive <card_id>. inputs: card id. outputs: updated card JSON with status set to archived. caution: write operation.
regex search cards: run deepvista card +grep "pattern" [--type TYPE] [-i] [--limit N] [-C N]. inputs: regex pattern (required), optional type filter, optional ignore-case flag (-i), optional limit (default 20), optional context lines (-C, default 0). outputs: JSON array with matching cards, line numbers, and matched content snippets. different from +search (this is literal/regex, not semantic). read-only.
show card URL: after any write operation (create, update, edit, pin, archive, delete), extract the card id from the response and present the URL https://app.deepvista.ai/vistabase?contextId=<id> as a clickable link to the user.
--tags '["tag1","tag2"]'.https://app.deepvista.ai/vistabase?contextId=<id>.