VistaBook

PREREQUISITE: Read deepvista-shared for auth, profiles, and global flags.

VistaBooks are structured checklist workflows stored as context cards. Each VistaBook is a template with phases and steps. Running a VistaBook creates a "run" -- an execution instance where the AI agent works through the checklist.

Commands

list

deepvista --profile local vistabook list [--limit N] [--page N]

Read-only -- lists all VistaBook templates.

get

deepvista --profile local vistabook get <vistabook_id>

Read-only -- returns full VistaBook content including checklist phases.

+run

deepvista --profile local vistabook +run <vistabook_id> [--input "context text"]

Start a VistaBook run -- the AI agent executes the workflow checklist step by step.

Flag	Required	Default	Description
`<vistabook_id>`	Yes	—	ID of the VistaBook template to run
`--input`	No	—	Context or instructions for the run

[!CAUTION] Write command -- creates a new VistaBook run (a chat session) and the agent may create/update context cards, search the web, and take other actions. Confirm with the user before executing.

Output is NDJSON (one JSON object per line) as the agent streams its response.

Use vistabook list first to find available VistaBook IDs.
Check run status afterward: vistabook +status <run_chat_id>
The run creates a linked chat session -- you can continue the conversation with chat +send.

+status

deepvista --profile local vistabook +status <run_chat_id>

Read-only -- shows run state (running, awaiting_input, completed, failed, paused).

+export

deepvista --profile local vistabook +export <vistabook_id> --format skill

Export a VistaBook as a SKILL.md file -- the VistaBook-as-Skill pipeline. Author workflows in DeepVista's GUI, then export them as installable agent skills.

Flag	Required	Default	Description
`<vistabook_id>`	Yes	—	ID of the VistaBook to export
`--format`	No	`skill`	Export format (currently only `skill`)

Read-only -- generates output but does not modify the VistaBook. The exported SKILL.md can be installed with npx skills add or placed in ~/.agents/skills/.

Examples

# List all vistabooks
deepvista --profile local vistabook list

# Run a vistabook
deepvista --profile local vistabook +run vb_abc123 --input "Focus on Q4 objectives"

# Check if a run is complete
deepvista --profile local vistabook +status chat_xyz789

# Export as a skill for other agents
deepvista --profile local vistabook +export vb_abc123 --format skill

deepvista-vistabook