// Executes AI tasks with strict resource limits and progress tracking. Use when the user needs to search the web, explore large codebases, or check dependencies. Prevents runaway execution by enforcing timeouts and limiting searches, file reads, and recursion depth.
| name | openflow |
| description | Executes AI tasks with strict resource limits and progress tracking. Use when the user needs to search the web, explore large codebases, or check dependencies. Prevents runaway execution by enforcing timeouts and limiting searches, file reads, and recursion depth. |
| allowed-tools | Bash(openflow:*) |
The openflow command executes AI tasks with built-in resource limits and real-time progress tracking. A structured workflow prevents runaway execution by enforcing timeouts and limiting operations.
openflow --version # Verify installation
For setup details, see https://github.com/Done-0/openflow#readme
openflow list ā see available workflowsopenflow info <flow-name> ā view flow details and limitsopenflow run <flow-name> --input '{"key": "value"}' ā run with parametersopenflow list # List all flows
openflow list --category research # Filter by category
Search the web with strict limits to prevent runaway searches. Uses DuckDuckGo Instant Answer API (free) or Brave Search API (set BRAVE_API_KEY env var for better results).
openflow run search_web --input '{"topic": "AI trends"}'
Use for: Research, competitive analysis, gathering information from the web
Limits: 60s max, 10 results hard limit, 12k tokens
Prevents: Runaway searches (real case: 234 searches, 45 minutes wasted)
Explore codebases with file limits to prevent reading entire projects.
openflow run explore_codebase --input '{"query": "authentication logic", "path": "."}'
Use for: Understanding large codebases, finding relevant code, navigating projects
Limits: 45s max, 20 files maximum, 15k tokens
Prevents: Reading entire project and exhausting tokens
Check dependencies with depth limits to prevent recursive analysis. Supports npm, pip, poetry, cargo, go, bundler.
openflow run check_dependencies --input '{"path": "."}'
Use for: Dependency audits, version conflict detection, understanding project dependencies
Limits: 30s max, 50 dependencies maximum, 8k tokens
Prevents: Recursively analyzing entire dependency tree
# Flow Management
openflow list # List available flows
openflow list --category <category> # Filter by category (research, codebase, dependencies, testing)
openflow info <flow-name> # Show flow details, steps, and limits
# Execution
openflow run <flow-name> --input '{"key": "value"}' # Execute flow with input
openflow run <flow-name> --input '...' --max-time 60 # Custom time limit
openflow run <flow-name> --input '...' --max-calls 30 # Custom tool call limit
openflow run <flow-name> --input '...' --max-tokens 15000 # Custom token limit
# Information
openflow --version # Show version
openflow --help # Show help
Each flow has default limits that can be customized:
| Option | Description | Default |
|---|---|---|
--max-time | Maximum execution time (seconds) | Flow-specific |
--max-calls | Maximum tool calls allowed | Flow-specific |
--max-tokens | Maximum token usage | Flow-specific |
# Example with custom limits
openflow run search_web \
--input '{"topic": "AI trends"}' \
--max-time 60 \
--max-calls 10 \
--max-tokens 15000
OpenFlow displays progress in the terminal:
[OpenFlow] Execution Plan
āāāāāāāāāāāāāāāāāāāāāāāā
Steps:
1. Search information (est. 10s)
2. Analyze sources (est. 15s)
3. Compare findings (est. 12s)
4. Generate report (est. 8s)
Estimated time: 45s
Resource limits: max 10 searches, 60s timeout
āāāāāāāāāāāāāāāāāāāāāāāā
[OpenFlow] Progress
āāāāāāāāāāāāāāāāāāāāāāāā
ā Search information 10.2s (used 10/10 searches)
ā Analyze sources 12.1s
ā³ Compare findings 9.8s [running...]
ā Generate report
Progress: āāāāāāāāāāāāāāāāāāāā 60%
Elapsed: 32.1s / Est. 45s | Searches: 10/10
āāāāāāāāāāāāāāāāāāāāāāāā
[OpenFlow] Completed
āāāāāāāāāāāāāāāāāāāāāāāā
ā All steps completed
Execution stats:
Time: 39.4s (5.6s faster than estimated)
Searches: 10/10 (100%)
Token usage: 8.2k/12k (68%)
ā Task completed within resource limits
ā Prevented runaway execution
āāāāāāāāāāāāāāāāāāāāāāāā
openflow run search_web --input '{"topic": "competitor analysis"}'
openflow run explore_codebase --input '{"query": "payment processing"}'
openflow run check_dependencies --input '{"file": "package.json"}'
openflow run generate_tests --input '{"file": "src/api.py"}'
Commands can be chained with &&:
openflow list && openflow info search_web
openflow run search_web --input '{"topic": "AI trends"}' && openflow list
openflow info <flow> shows steps and limits--max-time, --max-calls, --max-tokens as neededopenflow list to see available flows--input '{"key": "value"}'openflow --version and check installationOpenFlow executes synchronously and cleans up automatically. No manual cleanup needed.