Deepvista Recipe

DeepVista Recipe: Manage structured executable workflows (Recipes) and run them via the AI agent.

Recipe (Executable Workflows)

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

Recipes are structured checklist workflows. Each Recipe is a template with phases and steps. Running a Recipe creates a "run" — an execution instance where the AI agent works through the checklist.

Command: deepvista recipe <subcommand>

App URLs

After any write operation (run, create), always show the recipe URL to the user:

https://app.deepvista.ai/recipes/<id>

Extract the id from the JSON response and present it as a clickable link.

Commands

list

deepvista recipe list [--limit N] [--page N]

Read-only — lists all Recipe templates.

get

deepvista recipe get <recipe_id>

Read-only — returns full Recipe content including checklist phases.

run

deepvista recipe run <recipe_id> [--input "context text"]

Start a Recipe run — the AI agent executes the workflow checklist step by step.

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

[!CAUTION] Write command — creates a new Recipe 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.

status

deepvista recipe status <run_chat_id>

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

export

deepvista recipe export <recipe_id> --format skill

Export a Recipe as a SKILL.md file for use in AI agents.

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

Read-only — generates output but does not modify the Recipe.

discover

deepvista recipe discover [--search "query"] [--category persona|productivity|workflow] [--limit N]

Read-only — browse available recipes from the marketplace.

Flag	Required	Default	Description
--search / -s	No	—	Filter by title or description
--category / -c	No	—	Filter: persona, productivity, workflow
--limit	No	50	Max results

install

deepvista recipe install <recipe_id>

Install a marketplace recipe into your library.

Flag	Required	Default	Description
<recipe_id>	Yes	—	ID from deepvista recipe discover output

[!CAUTION] Write command — creates a new Recipe in your library. Confirm with the user before executing.

Examples

# List all recipes
deepvista recipe list

# Run a recipe
deepvista recipe run vb_abc123 --input "Focus on Q4 objectives"

# Check if a run is complete
deepvista recipe status chat_xyz789

# Export as a skill for other agents
deepvista recipe export vb_abc123 --format skill

# Browse marketplace recipes
deepvista recipe discover --category persona

# Search marketplace
deepvista recipe discover --search "email"

# Install a marketplace recipe
deepvista recipe install persona-researcher

See Also

• deepvista-shared — Auth and global flags
• deepvista-chat — Continue a Recipe run conversation