clawhubby @jingconan

Deepvista Vistabase Card

Item: Deepvista Vistabase Card
Rating: 7.3
Author: Implexa

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

copies: implexa run clawhub/deepvista-vistabase-card

view source

installs

stars

karma

SkillRank score ↗

7.3/ 10

evaluated by implexa, claude-haiku-4-5 · 2026-05-26

deepvista-vistabase-card manages a hybrid-searchable knowledge base of typed context cards (person, organization, topic, note, file, etc.) with crud operations, semantic/regex search, and status controls (pin, archive). requires deepvista-shared for auth.

structure

9.0

trigger phrases

8.0

procedure

8.0

edge cases

5.0

documentation

8.0

strengths

view original SKILL.md from clawhubclick to expand

---
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)

related skills

semantically similar in the cross-vendor index

clawhub

62% match

sciverse academic retrieval

Retrieve academic papers by structured metadata, perform semantic chunk search for RAG, and read byte-range content for citation-grade scientific literature.

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.

intent

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.

inputs

deepvista CLI: installed via uv install deepvista-cli. check install with deepvista card --help.
auth context: inherited from deepvista-shared skill (API token, profile selection, workspace context).
card data: when creating or updating, provide card type, title, optional content, optional tags as JSON array, optional enrichment flag.
card id: uuid of target card for get, update, edit, delete, pin, archive, or similar operations.
search/grep parameters: query text or regex pattern, optional type filter, optional limit and ordering.

procedure

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.

decision points

if user requests write operation (create, update, edit, delete, pin, archive): always ask for confirmation before executing the command. do not proceed without explicit approval.
if search returns empty results: inform user no cards match the query. suggest refining the query, broadening type filters, or using +grep for literal content search.
if edit command fails with "multiple matches found": ask user to provide more surrounding context in old-string to disambiguate, or pass --replace-all flag if replacing all occurrences is intended.
if card id is invalid or not found: catch the error and tell user the card does not exist or has been deleted. suggest listing cards or searching to find the correct id.
if tags array is malformed JSON: reject the command and show the user the expected format: --tags '["tag1","tag2"]'.
if --order-by is used without --order direction: note that direction defaults to ascending. ask user if descending is preferred.
if --no-enrich flag is passed on create: skip semantic embedding generation. card will still be keyword-indexed but will not appear in semantic search results. useful for sensitive or private cards.
if network timeout or API error occurs: retry once after 2 seconds. if it fails again, report the error and suggest checking auth (deepvista-shared) or network connectivity.
if rate limit is hit (429 response): wait 60 seconds and retry. inform user that deepvista has temporarily throttled requests.

output contract

list command: returns JSON array of card objects, each with fields: id (uuid), type (string), title (string), status (pinned, archived, normal), created_at (ISO 8601 timestamp), updated_at (ISO 8601 timestamp), tags (array of strings).
get, create, update, edit, pin, archive commands: return single card JSON object with all fields above plus content (string), embeddings (optional, metadata only), and full metadata.
delete command: returns confirmation JSON with id and deleted flag set to true.
search command: returns JSON array of matched cards with similarity_score field (0 to 1 float), ordered descending by score.
similar command: returns JSON array of related cards with similarity_score field, ordered descending by score. source card excluded.
grep command: returns JSON array of matches, each with id, card_title, line_number (integer), matched_line (string), context_before (array of strings, if -C > 0), context_after (array of strings, if -C > 0).
all responses: include metadata footer with timestamp and profile used.
app URL: always display after write operations in the format https://app.deepvista.ai/vistabase?contextId=<id>.

outcome signal

list command succeeds: user sees paginated table or JSON of their cards with correct counts and filters applied.
get command succeeds: user sees full card details including title, type, content, tags, timestamps, and status.
create command succeeds: user sees new card JSON with assigned uuid and confirmation message showing the card URL. card is immediately searchable.
update/edit command succeeds: user sees modified card JSON reflecting the changes and card URL.
delete command succeeds: user sees confirmation that card with id X has been deleted. card no longer appears in list or search results.
search command succeeds: user sees ranked list of matching cards with relevance scores. top result is most relevant.
similar command succeeds: user sees list of semantically related cards, useful for context discovery.
pin/archive command succeeds: user sees status field in response set to pinned or archived, and card URL.
grep command succeeds: user sees matching lines with line numbers and surrounding context (if requested). useful for finding specific text or patterns in card bodies.
error handling: all failures produce clear error messages (invalid id, auth failure, malformed json, etc.) with remediation steps.