Tosca Cloud — hybrid CLI automation
Default runtime: toscactl. Gap runtime: tn (/tosca MCP, --loop, --robot) for Builder, DI, mobile, loop, and robot — see runtime-routing.md.
Prerequisite: toscactl login + workspace set. For gap workflows: configure_tn_connection.py + tn --setup.
Session checklist
Tosca Cloud session:
- [ ] python3 verify_toscactl.py (default path)
- [ ] runtime-routing.md — pick toscactl vs tn
- [ ] Intent — journeys-index.md OR one workflow
- [ ] Execute — toscactl --json --silent OR tn per routing
- [ ] Verify — re-read artifact or run state
Execution modes
| Runtime | When | Doc |
|---|---|---|
| toscactl | Connect, search, run, diagnose, history, agents, datasets | toscactl-invocation.md |
| tn | Builder, DI, mobile, loop, robot (CLI gaps) | tn-invocation.md |
Conditional routing
| User goal | Read first | Runtime |
|---|---|---|
| Pick runtime | runtime-routing.md | — |
| Pick path / detect CLIs | path-selection.md | both |
| Map intent to docs | journeys-index.md | per skill |
| toscactl commands | toscactl-invocation.md · vendored tosca-commands/* |
toscactl |
| tn gap workflows | tn-invocation.md | tn |
| Playlist / execution | playlist-orchestration.md | toscactl |
| Builder / test cases | builder-orchestration.md | tn |
| Data Integrity | di-orchestration.md | tn (+ toscactl datasets for TDM) |
| Mobile / API execution / simulation | respective orchestration | tn |
| Tester journey | journeys-index.md | per skill |
Workflow templates
| Workflow | File | Runtime |
|---|---|---|
| Connect tenant | connect-tenant.md | toscactl |
| Inspect space | inspect-space.md | toscactl |
| Search artifacts | search-artifacts.md | toscactl |
| Run playlist | run-playlist.md | toscactl |
| Analyze run failures | analyze-run-failures.md | toscactl |
| Create playlist | create-playlist.md | toscactl |
| Manage folder | manage-folder.md | tn |
| Rename playlist items | rename-playlist-items.md | tn |
| Scaffold test case | scaffold-test-case.md | tn |
| Manage API message | manage-api-message.md | tn |
| Data Integrity | di-getting-started.md | tn |
| Loop / robot | loop-autonomous.md, robot-monitoring.md | tn |
Full index: reference/workflows-index.md
Vendored toscactl command skills
Command skills in this pack include tosca-find, tosca-run, tosca-setup, toscactl-reference, tosca-agents, tosca-datasets, and others (sibling folders in this IDE tree).
Journey skills
See journeys-index.md. Consumer packs include AGENTS.md.fragment for routing.
Out of scope
| Capability | Use instead |
|---|---|
| On-prem Commander | Commander CLI |
| Direct IDE MCP (no CLI) | Tosca Cloud MCP |