pi-factory-gate
AI Factory orchestration gateway for pi agents — dispatch jobs, manage environments, list agents/workers/workflows, and stream results from a wrok.in orchestrator.
Install
pi install npm:@bytesbrains/pi-factory-gate
Configuration
Add a .factoryrc.yml to your repo root:
orchestratorUrl: http://localhost:3002
defaultEnvironment: default
defaultLimit: 20
requestTimeout: 15000
maxLogLines: 500
| Key |
Default |
Description |
orchestratorUrl |
http://localhost:3002 |
Base URL of the wrok.in orchestrator |
defaultEnvironment |
(none) |
Default environment for job dispatch |
defaultLimit |
20 |
Default page size for list operations |
requestTimeout |
15000 |
API call timeout in ms |
maxLogLines |
500 |
Max lines for streamed job output |
Tools
Agents
| Tool |
Description |
factory_list_agents |
List all agents, optionally filtered by environment |
factory_get_agent |
Get agent detail including inheritance and resolved config |
Jobs
| Tool |
Description |
factory_create_job |
Dispatch a job (single, chain, or parallel mode) |
factory_get_job |
Get job status and results |
factory_list_jobs |
List all jobs in the factory |
factory_stream_job |
Poll for completion, returns final state |
Environments
| Tool |
Description |
factory_list_environments |
List all registered environments |
factory_get_environment |
Get environment detail |
factory_create_environment |
Register a new environment (clone a repo) |
Workers
| Tool |
Description |
factory_list_workers |
List all workers with health/status |
Workflows
| Tool |
Description |
factory_list_workflows |
List workflow templates (DB + disk discovery) |
factory_run_workflow |
Execute a workflow template |
Events & Status
| Tool |
Description |
factory_get_events |
Get recent system events |
factory_status |
Health check — is the orchestrator reachable? |
About wrok.in
This gate works with the wrok.in AI Factory — a personal AI workflow orchestrator that manages pi workers across Docker containers with multi-repo environments, agent inheritance, DB-backed agents, and workflow scheduling.
License
MIT
Built and maintained by BytesBrains — AI automation & agents, engineered to production standards.
The model proposes, code guarantees.