Getting Started
Architecture & Reference
spec.yaml
to_home/
spec.a2a.port
sac listen
metadata.labels
spec
spec.apptainer
spec.available_harnesses.claude-code.account
spec.available_harnesses.<key>.compression
spec.available_harnesses.hermes.background_review
spec.available_harnesses.hermes.run_budget_seconds
spec.claude
spec.comms
spec.claude.model
spec.health
spec.restart
spec.watchdog
spec.autonomous
spec.a2a
spec.listen
~/.scitex/agent-container/config.yaml
spec.mcp_servers
spec.telegram
spec.hooks
spec.extensions
kind: AgentProxy
spec.proxy
POST /agents/<name>/turn
sac agents send
sac agents tail
sac --on <peer>
--writable
--writable-tmpfs
/home/agent
~/.claude.json
~/.claude/.credentials.json
~/.claude/settings.json
API Reference
AgentConfig
AgentConfig.name
AgentConfig.runtime
AgentConfig.harness
AgentConfig.harness_key_is_legacy
AgentConfig.engines
AgentConfig.engine_key
AgentConfig.reasoning_effort
AgentConfig.service_tier
AgentConfig.max_context_tokens
AgentConfig.upstream_deadline_seconds
AgentConfig.client_abandonment_seconds
AgentConfig.subscription_provider
AgentConfig.subscription_account
AgentConfig.residency
AgentConfig.image
AgentConfig.model
AgentConfig.workdir
AgentConfig.python_venv
AgentConfig.env
AgentConfig.env_files
AgentConfig.screen_name
AgentConfig.labels
AgentConfig.container
AgentConfig.claude
AgentConfig.health
AgentConfig.watchdog
AgentConfig.restart
AgentConfig.autonomous
AgentConfig.hermes_background_review
AgentConfig.hermes_failover
AgentConfig.hermes_yolo
AgentConfig.hermes_run_budget_seconds
AgentConfig.hermes_compression
AgentConfig.opencode_approval_policy
AgentConfig.opencode_run_budget_seconds
AgentConfig.opencode_serve_port
AgentConfig.apptainer
AgentConfig.hooks
AgentConfig.listen
AgentConfig.extensions
AgentConfig.skills
AgentConfig.startup_commands
AgentConfig.startup_prompts
AgentConfig.exclude_hooks
AgentConfig.exclude_skills
AgentConfig.mcp_servers
AgentConfig.multiplexer
AgentConfig.hosts_spec
AgentConfig.scheduling
AgentConfig.config_path
AgentConfig.mounts
AgentConfig.user
AgentConfig.a2a
AgentConfig.comms
AgentConfig.lineage
AgentConfig.delegation
AgentConfig.kind
AgentConfig.proxy
AgentConfig.to_home
AgentConfig.to_home_layers
AgentConfig.expanded_workdir
AgentConfig.__init__()
ClaudeSpec
ClaudeSpec.model
ClaudeSpec.channels
ClaudeSpec.flags
ClaudeSpec.raw_options
ClaudeSpec.session
ClaudeSpec.continue_max_age_minutes
ClaudeSpec.resume_id
ClaudeSpec.auto_accept
ClaudeSpec.account
ClaudeSpec.credentials_file
ClaudeSpec.credentials_files
ClaudeSpec.provider
ClaudeSpec.__init__()
ContainerSpec
ContainerSpec.image
ContainerSpec.volumes
ContainerSpec.network
ContainerSpec.mount_host_claude
ContainerSpec.__init__()
DelegationSpec
DelegationSpec.max_concurrent_children
DelegationSpec.worktree_isolation
DelegationSpec.__init__()
EngineDefaultError
EngineError
EngineSpec
EngineSpec.key
EngineSpec.harness
EngineSpec.model
EngineSpec.provider
EngineSpec.provider_declared
EngineSpec.subscription_provider
EngineSpec.subscription_account
EngineSpec.reasoning_effort
EngineSpec.service_tier
EngineSpec.max_context_tokens
EngineSpec.upstream_deadline_seconds
EngineSpec.client_abandonment_seconds
EngineSpec.env
EngineSpec.is_default
EngineSpec.__init__()
HealthSpec
HealthSpec.enabled
HealthSpec.interval
HealthSpec.timeout
HealthSpec.method
HealthSpec.__init__()
HookSpec
HookSpec.pre_start
HookSpec.post_start
HookSpec.pre_stop
HookSpec.post_stop
HookSpec.on_compact
HookSpec.on_restart
HookSpec.on_diff
HookSpec.counts()
HookSpec.__init__()
HermesCompressionSpec
HermesCompressionSpec.threshold
HermesCompressionSpec.threshold_tokens
HermesCompressionSpec.target_ratio
HermesCompressionSpec.tail_mode
HermesCompressionSpec.in_place
HermesCompressionSpec.__init__()
HermesFleetBudgetError
HermesFleetContextBudget
HermesFleetContextBudget.threshold_tokens
HermesFleetContextBudget.usable_capacity_tokens
HermesFleetContextBudget.reserved_capacity_tokens
HermesFleetContextBudget.agent_count
HermesFleetContextBudget.__init__()
HostsSpec
HostsSpec.host
HostsSpec.hosts
HostsSpec.__init__()
ListenPort
ListenPort.port
ListenPort.proto
ListenPort.path
ListenPort.name
ListenPort.owner
ListenPort.__init__()
ProviderSpec
ProviderSpec.base_url
ProviderSpec.auth_token_env
ProviderSpec.__init__()
ProviderSpec.allowed_tools
ProviderSpec.extra_headers
ProviderSpec.hermes_provider
ProxySpec
ProxySpec.upstream
ProxySpec.trust
ProxySpec.redact
ProxySpec.__init__()
ProxySpec.timeout_s
RestartSpec
RestartSpec.policy
RestartSpec.max_retries
RestartSpec.backoff_initial
RestartSpec.backoff_max
RestartSpec.backoff_multiplier
RestartSpec.prune_on_stop
RestartSpec.__init__()
SchedulingSpec
SchedulingSpec.mode
SchedulingSpec.preferred_host
SchedulingSpec.fallback_hosts
SchedulingSpec.__init__()
SkillsSpec
SkillsSpec.required
SkillsSpec.available
SkillsSpec.injection_mode
SkillsSpec.match_by
SkillsSpec.match_style
SkillsSpec.__init__()
StartupCommand
StartupCommand.delay
StartupCommand.command
StartupCommand.__init__()
UnknownEngineError
WatchdogSpec
WatchdogSpec.enabled
WatchdogSpec.interval
WatchdogSpec.resp_y_n
WatchdogSpec.resp_y_y_n
WatchdogSpec.resp_waiting
WatchdogSpec.__init__()
apply_engine()
compose_effective_name()
derive_hermes_fleet_context_budget()
load_config()
resolve_config()
resolve_hostname()
select_engine()
substitute_hostnames()
validate_config()
PromptHandler
PromptHandler.name
PromptHandler.detect
PromptHandler.keys
PromptHandler.priority
PromptHandler.__init__()
_detect_bypass_permissions()
_detect_dev_channels()
has_esc_cancel_modal()
_detect_thinking_effort()
_detect_skip_permissions_yn()
_detect_mcp_json_edit()
_detect_press_enter_continue()
_detect_file_trust()
_detect_file_trust_radio()
_detect_external_imports()
_detect_login_method()
_detect_theme_selection()
_detect_compose_pending_unsent()
_detect_resume_session()
_detect_codex_dir_trust()
_detect_codex_hooks_review()
_CODEX_COMPOSER_MARKERS
_codex_usage_limit_pane()
codex_blocking_modal()
_detect_codex_done()
_detect_hermes_contributor_tier()
_detect_done()
register_prompt()
_LIVE_WINDOW_LINES
_recent_tail()
detect_and_respond()
detect()
respond_modal()
is_ready()