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:

text

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

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

Commands#

list#

bash

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

Read-only — lists all Recipe templates.

get#

bash

deepvista recipe get <recipe_id>

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

run#

bash

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

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

FlagRequiredDefaultDescription<recipe_id>Yes—ID of the Recipe template to run--inputNo—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#

bash

deepvista recipe status <run_chat_id>

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

export#

bash

deepvista recipe export <recipe_id> --format skill

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

FlagRequiredDefaultDescription<recipe_id>Yes—ID of the Recipe to export--formatNoskillExport format (currently only skill)

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

discover#

bash

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

Read-only — browse available recipes from the marketplace.

FlagRequiredDefaultDescription--search / -sNo—Filter by title or description--category / -cNo—Filter: persona, productivity, workflow--limitNo50Max results

install#

bash

deepvista recipe install <recipe_id>

Install a marketplace recipe into your library.

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

bash

# 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