Chat#

PREREQUISITE: Read deepvista-shared 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.

FlagRequiredDefaultDescription<message>Yes—Your message to the agent--chat-idNo—Continue an existing chat session--newNofalseForce 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 — Auth and global flags
• deepvista-vistabase — View implicit context accumulated from Chat