DeepVista Chat: Send messages to the AI agent and manage chat sessions.
---
name: deepvista-chat
description: "DeepVista Chat: Send messages to the AI agent and manage chat sessions."
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 chat --help"
---
# Chat
> **PREREQUISITE:** Read [deepvista-shared](../deepvista-shared/SKILL.md) for auth, profiles, and global flags.
Chat with the DeepVista AI agent. The agent can search your knowledge base, create cards, run web searches, and execute tools.
## Commands
### sessions
```bash
deepvista chat sessions [--limit N] [--offset N] [--search "query"]
```
Read-only — list chat sessions.
### get
```bash
deepvista chat get <chat_id>
```
Read-only — returns session metadata (`id`, `summary`, `created_at`, `status`). Full message history is not returned by this endpoint.
### delete
```bash
deepvista chat delete <chat_id>
```
> [!CAUTION] Destructive command — confirm with user before executing.
### +send
```bash
deepvista chat +send "your message" [--chat-id ID] [--new]
```
> [!CAUTION]
> This is a **write** command — creates/updates chat sessions and the agent may create cards, search the web, and take other actions. Confirm with the user before executing.
| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `<message>` | Yes | — | Your message to the agent |
| `--chat-id` | No | — | Continue an existing chat session |
| `--new` | No | false | Force start a new conversation |
Output is **NDJSON** — one JSON object per line, streamed as the agent responds.
## SSE Event Format
`+send` streams events in this structure. Parse `page_delta` events to get the agent's response text:
```json
{"type": "chat_session", "id": "abc123", ...}
{"type": "page", "page": {"user_instruction": "...", ...}}
{"type": "page_delta", "parts": [
{"type": "tool_result", "output": "partial response text...", "done": false}
], "page_index": 0}
{"type": "page_delta", "parts": [
{"type": "tool_result", "output": "full response text", "done": true, "options": ["follow-up 1", "follow-up 2"]}
]}
```
Key fields:
- `type: "chat_session"` — first event; contains the `id` of the session
- `type: "page_delta"` — carries the streamed response
- `parts[].type: "tool_result"` — the agent's text; `output` is the **full accumulated text so far** (not an incremental delta)
- `parts[].done: true` — final chunk; `options` may contain suggested follow-up prompts
## Examples
```bash
# Send a message (new conversation)
deepvista chat +send "What are my open tasks?" --new
# Continue an existing conversation
deepvista chat +send "Tell me more about the first one" --chat-id abc123
# Ask the agent to create a note
deepvista chat +send "Create a note summarizing our ML strategy discussion"
# List recent sessions
deepvista chat sessions --limit 5
# Search sessions by summary
deepvista chat sessions --search "roadmap"
```
## See Also
- [deepvista-shared](../deepvista-shared/SKILL.md) — Auth and global flags
- [deepvista-vistabase](../deepvista-vistabase/SKILL.md) — View implicit context accumulated from Chat
don't have the plugin yet? install it then click "run inline in claude" again.