Skill: jingconan/deepvista-vistabase-card (version 0.1.0-alpha.21)

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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal:  | SkillSpector: clean (LOW)