scitex-agent-container
[WHAT] `spec.yaml` selects Claude, Codex, Hermes or OpenCode in Apptainer; A2A inbound (`POST /v1/turn`), SSH deploy and JSON status. [WHEN] Agents, fleets, Hermes profiles, goal_judge errors, MCP, A2A; `sac agents start`, `scitex-agent-container`, `spec.yaml`. [HOW] `pip install scitex-agent-container`; `sac agents start <name>` or `import scitex_agent_container`.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- scitex-agent-container
- tags
- [ "scitex-agent-container" ]
- interfaces
- { "cli": 3, "mcp": 1, "http": 0, "python": 2, "skills": 2 }
- description
- [WHAT] `spec.yaml` selects Claude, Codex, Hermes or OpenCode in Apptainer; A2A inbound (`POST /v1/turn`), SSH deploy and JSON status. [WHEN] Agents, fleets, Hermes profiles, goal_judge errors, MCP, A2A; `sac agents start`, `scitex-agent-container`, `spec.yaml`. [HOW] `pip install scitex-agent-container`; `sac agents start <name>` or `import scitex_agent_container`.
- primary_interface
- cli
02 资源文件 58
- 参考文档01_config-v3.md9.0 KB
- 参考文档01_installation.md4.7 KB
- 参考文档02_multiplexer.md1.8 KB
- 参考文档02_quick-start.md3.5 KB
- 参考文档03_auto-accept.md3.1 KB
- 参考文档03_python-api.md3.8 KB
- 参考文档04_cli-reference.md8.3 KB
- 参考文档04_resource-management.md2.9 KB
- 参考文档05_mcp-tools.md4.9 KB
- 参考文档05_resource-heartbeat.md3.5 KB
- 参考文档06_env-injection-ports.md3.2 KB
- 参考文档06_http-api.md3.6 KB
- 参考文档07_a2a-protocol-extension-fields.md7.4 KB
- 参考文档07_a2a-protocol.md10.0 KB
- 参考文档08_templates.md2.8 KB
- 参考文档10_cli.md9.2 KB
- 参考文档11_remote-deploy.md7.6 KB
- 参考文档12_wsl-connectivity.md7.4 KB
- 参考文档13_observability.md3.4 KB
- 参考文档14_claude-session-state.md7.0 KB
- 参考文档15_claude-session.md6.1 KB
- 参考文档16_claude-session-migration.md3.3 KB
- 参考文档17_inbound-turn-endpoint.md6.8 KB
- 参考文档18_full-agent-delegation.md8.7 KB
- 参考文档19_full-agent-troubleshooting.md6.9 KB
- 参考文档20_env-vars.md9.8 KB
- 参考文档21_cli-startup-budget.md4.6 KB
- 参考文档22_host-passthrough.md4.9 KB
- 参考文档23_telegram-integration.md8.4 KB
- 参考文档23_telegram-one-token-one-poller.md6.7 KB
- 参考文档23_telegram-rail-verdict.md7.3 KB
- 参考文档24_image-build.md4.8 KB
- 参考文档25_claude-setup-delivery.md10.0 KB
- 参考文档26_credentials-account-selection.md3.5 KB
- 参考文档26_credentials-rotation-host.md9.4 KB
- 参考文档26_credentials-rotation.md8.7 KB
- 参考文档27_credentials-relogin.md5.3 KB
- 参考文档28_credential-refresh.md5.1 KB
- 参考文档29_progress-reporting-to-lead.md5.2 KB
- 参考文档30_responsiveness-background-work.md9.9 KB
- 参考文档31_worktree-path-safety.md4.3 KB
- 参考文档32_nested-apptainer-builds.md3.9 KB
- 参考文档33_twin-spawning.md7.8 KB
- 参考文档34_spec-is-a-contract-not-state.md6.5 KB
- 参考文档35_spec-authority.md2.2 KB
- 参考文档40_periodic-drive-consumer.md2.6 KB
- 参考文档40_troubleshooting.md5.8 KB
- 参考文档41_claude-worktree-relocation.md4.2 KB
- 参考文档42_tui-auth-watchdog.md9.9 KB
- 参考文档43_tui-auth-watchdog-maintenance.md9.1 KB
- 参考文档44_agent-to-agent-recovery.md8.7 KB
- 参考文档45_agent-to-agent-recovery-tmux.md5.9 KB
- 参考文档46_agents-list-auth-cache.md5.0 KB
- 参考文档47_hermes-profile-resolution.md9.9 KB
- 参考文档48_model-availability.md4.9 KB
- 脚本peer_docs_match_code.py2.0 KB
- 脚本responsiveness_doctrine.py2.0 KB
- 脚本scitex_smoke_test.py4.5 KB
03 SKILL.md 正文
scitex-agent-container
Interfaces: Python ⭐⭐ · CLI ⭐⭐⭐ (primary) · MCP ⭐ · Skills ⭐⭐ · Hook — · HTTP —
Define an agent in spec.yaml, select its harness and launch mode,
run it in Apptainer locally or via SSH, and observe with
sac agents list/tail/health.
Claude and direct Codex support TUI/headless; Hermes and OpenCode support TUI. Authentication is separate from harness selection. OpenAI Agents SDK has no lifecycle launch adapter; Command Code is unregistered. See how-sac-works.md for the support matrix.
What the package ships
| Surface | Location |
|---|---|
| Python API | scitex_agent_container (AgentConfig, load_config, Registry; agent.*/peer.*/host.*) |
| CLI | scitex-agent-container, sac — see 10_cli.md |
| MCP servers | None bundled — agents spawn their own via to_home/.mcp.json |
| Config format | v3 scitex-agent-container/v3 only — v2 rejected |
Sub-skills
Onboarding & interfaces
- 01_installation.md — pip install + auth + per-host hook
- 02_quick-start.md — first agent
- 03_python-api.md — Python API
- 04_cli-reference.md — CLI reference
- 05_mcp-tools.md —
sac mcpserver + tool inventory - 06_http-api.md —
POST /v1/turnwire format (spec.a2a.portenables)
Core
- 01_config-v3.md — v3 format; dir-as-SSoT
- 02_multiplexer.md — vestigial; lead-only tmux wrap
- 03_auto-accept.md — modular prompt handlers
- 04_resource-management.md
- 05_resource-heartbeat.md
- 06_env-injection-ports.md — four env-injection ports
- 07_a2a-protocol.md — native A2A protocol (
sac a2a serve) - 07_a2a-protocol-extension-fields.md —
x-scitex-agent-container.*AgentCard fields - 08_templates.md — six pattern templates
- 14_claude-session-state.md — state-dir layout, auth precedence
- 15_claude-session.md — SDK runner +
POST /v1/turninbound - 16 — historical claude-code→SDK migration
- 17_inbound-turn-endpoint.md —
POST /v1/turnwire format - 18_full-agent-delegation.md — delegate to another full agent
- 19 — stuck-peer recovery + reaper
- 33 — context-inheriting twin
- 34
- 35
Workflows
- 10_cli.md — CLI commands and Python API
- 11_remote-deploy.md — SSH deployment, src files, venv
- 12 — WSL connectivity notes
- 24_image-build.md — apptainer
.sifbuild/rebuild, rebuild-to-ship gotcha - 25_claude-setup-delivery.md —
to_home→$HOME, overlay, settings hook - 26_credentials-rotation.md — OAuth + auth mechanics
- 26_credentials-rotation-host.md — refresh + one-refresher invariant + host cron
- 26-acct — boot account pin/picker + 7d policy
- 27_credentials-relogin.md — verified re-login + 401 recovery
- 28_credential-refresh.md — refresh creds without restart; agents re-read next turn
- 29_progress-reporting-to-lead.md — milestone push via a2a_send
- 30 — short turns; long work backgrounded
- 31_worktree-path-safety.md — keep worktrees outside
.claude*/ - 32
Reference
- 13_observability.md —
sac agents statusJSON contract - 42 — TUI auth detection
- 43 — auth matcher maintenance
- 44 — wedged-peer recovery
- 45 — tmux recovery and MCP reconnect
- 46 — persisted auth verdict →
auth-failedin the fleet view - 47_hermes-profile-resolution.md — profiles, project context, skills, judge errors
- 48_model-availability.md — API preflights, caps, fresh restarts, Say Hi
Lessons
- 40_troubleshooting.md — troubleshooting
- 40b
- 41
Environment
- 20 —
SCITEX_*env vars read at runtime - 21 — keep
sac --help< 500 ms via LazyGroup - 22 —
spec.mounts/spec.user/spec.env; host fs/git/gh - 23 — Telegram wake contract, token resolution
- 23-rail — rail up/down/unknown;
cct-audit - 23-1t1p — one token, one consumer
30-second start
See 02_quick-start.md. After installation, place
spec.yaml in ~/.scitex/agent-container/agents/<name>/; use
sac agents start <name> / list / tail.
04 同仓库更多 Skills
hello
暂无简介
example-skill
[WHAT] Project-specific context and reusable knowledge for this agent — coding conventions, tool usage patterns, domain vocabulary. [WHEN] Always loaded at agent startup; provides background the agent needs to work effectively in this codebase. [HOW] Place one `.md` file per topic in this directory; each file is loaded into the agent's context via the skills system.