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

deepvista chat sessions [--limit N] [--offset N] [--search "query"]

Read-only — list chat sessions.

get

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

deepvista chat delete <chat_id>

[!CAUTION] Destructive command — confirm with user before executing.

+send

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:

{"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

# 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"

deepvista-chat