Dev Commands

Commands for local development: run, serve, validate, scaffold, configure, and diagnose.

kdeps run

Run a workflow locally (default execution mode).

kdeps run [workflow.yaml | package.kdeps] [flags]

Arguments:

• workflow.yaml -- Path to workflow file or directory containing workflow.yaml
• package.kdeps -- Path to packaged workflow file

Flags:

Flag	Description	Default
--dev	Enable hot reload mode	false
--port	API server port number	From workflow config
--debug	Enable debug logging	false
--interactive	Open an interactive LLM REPL alongside the running workflow	false

Examples:

kdeps run workflow.yaml                    # Run from file
kdeps run myapp.kdeps                      # Run from package
kdeps run workflow.yaml --dev              # Hot reload
kdeps run workflow.yaml --debug            # Debug logging
kdeps run workflow.yaml --port 16395       # Custom port
kdeps run workflow.yaml --interactive      # LLM REPL alongside server

---

kdeps serve

Start agent mode -- an interactive LLM loop where whole workflows and components are registered as callable tools. Pass a single file to expose one workflow tool plus its components, or a folder to expose every workflow and agency inside as separate tools along with all their components.

kdeps serve <path> [flags]

Flags:

Flag	Default	Description
--model	KDEPS_AGENT_MODEL or llama3.2	LLM model name
--backend	KDEPS_AGENT_BACKEND or ollama	LLM backend
--base-url	KDEPS_AGENT_BASE_URL	LLM API base URL
--system	(none)	System prompt injected at conversation start
--debug	false	Enable debug logging

Examples:

kdeps serve ./my-agent/                                       # one tool: metadata.name
kdeps serve ./agents/                                         # all workflows in folder
kdeps serve ./my-agent/ --model mistral
kdeps serve ./agents/ --system "You are a helpful assistant."

See Agent Mode for full details.

---

kdeps validate

Validate workflow configuration against schema and business rules.

kdeps validate [workflow.yaml | directory] [flags]

What it validates:

• YAML syntax
• Schema compliance (JSON Schema)
• Resource dependencies
• Expression syntax
• Circular dependency detection
• Business rules
• Static analysis (unreachable resources, bad expression refs, missing component inputs)

Examples:

kdeps validate workflow.yaml
kdeps validate .                            # Validate all in directory
kdeps validate myapp.kdeps                  # Validate package

Output:

Validating: workflow.yaml

✓ YAML syntax valid
✓ Schema validation passed
✓ Resource dependencies resolved
✓ No circular dependencies
✓ Expression syntax valid

Workflow validated successfully

---

kdeps new

Create a new AI agent with interactive prompts.

kdeps new [agent-name] [flags]

Flags:

Flag	Description	Default
--template, -t	Agent template to use	api-service
--force	Overwrite existing directory	false

Available templates: api-service, sql-agent

Examples:

kdeps new my-agent                           # Uses api-service template
kdeps new my-agent --template sql-agent      # SQL agent template
kdeps new my-agent --force                   # Overwrite existing

Generated structure:

my-agent/
├── workflow.yaml
├── resources/
│   ├── http_client.yaml
│   ├── llm.yaml
│   └── response.yaml
└── README.md

---

kdeps edit

Open the global kdeps configuration file (~/.kdeps/config.yaml) in your editor. Scaffolded if it doesn't exist.

kdeps edit [flags]

Editor resolution: $KDEPS_EDITOR > $VISUAL > $EDITOR > vi

kdeps edit
KDEPS_EDITOR=code kdeps edit                # Open in VS Code

---

kdeps doctor

Run system health checks to diagnose common configuration and environment issues.

kdeps doctor [flags]

Checks:

Check	Description
Config file	Existence of ~/.kdeps/config.yaml
Config validation	Typos in API key names, missing keys
Ollama	TCP connectivity to the Ollama server
Python	python3 availability in PATH
Backend/API key	Cloud backend configured without its API key
Agents	Installed agent count
Env vars	Critical environment variables set

Exits with code 1 when any check has FAIL status.

---

kdeps chat

Interactive AI assistant that generates and runs kdeps workflows from natural language.

kdeps chat [flags]

Flags:

Flag	Description	Default
--model	LLM model for workflow generation	From config
--base-url	LLM backend base URL	http://localhost:11434
--session	Resume a previous session by ID	New session
--no-execute	Generate workflow but do not allow /run	false

REPL slash commands:

Command	Description
/show	Print the generated workflow YAML
/run	Execute the workflow
/save [path]	Save workflow to directory
/export	Show Kubernetes manifests
/reset	Clear conversation and start fresh
/quit	Exit

kdeps chat                                    # Start interactive assistant
kdeps chat --model gpt-4o                     # Use specific model
echo "list files in /tmp" | kdeps chat --no-execute

See Also

• CLI Overview -- global flags, exit codes, env vars, workflows
• Registry Commands -- search, install, publish
• Packaging Commands -- bundle, export, build