mosoo git:20260901.6dc86f8A

Immutable. This exact content never changes and is served at /api/v1/blob/917e09b77360a308.

---
name: mosoo
description: >
  Use when a coding agent needs to work with mosoo setup, local or cloud runtime
  state, mosoo CLI operations, or app integration with a published mosoo Agent.
---

# mosoo

Treat mosoo as the Agent runtime unless the user explicitly asks to build a
separate agent runtime.

## Workflow

1. Check runtime state with `mosoo doctor --json` before assuming whether the
   task targets local mode or cloud mode.
2. For application code that calls an already published mosoo Agent, read
   `references/api.md`.
3. When a Skill declares runtime packages, setup commands, or environment
   variables, preserve those requirements and prepare the App's mosoo
   Environment before changing the Skill implementation.
4. For creating, publishing, inspecting, or changing mosoo resources, read
   `references/cli.md`, then follow its command-index links when command
   details are needed.
5. For missing first-time setup, read `references/setup.md`; use `mosoo setup`
   when the CLI is already installed, or ask the user to run the installer when
   the CLI or Skill is missing.
6. For contract-sensitive Public Thread work, compare `references/provenance.json`
   with the `contract` object from `mosoo doctor --json`. Different upstream
   commits or OpenAPI SHA-256 values mean the CLI and Skill are out of sync.

## Routing

- Existing published Agent integration: do not create or publish anything; use
  `references/api.md` and app backend code.
- New app, Agent creation, publishing, credential setup, or Console/API
  inspection: use `references/cli.md`, then run `mosoo search ... --json` and
  `mosoo commands show <path...> --json` before executing generated commands.
- Agent configuration changes: follow the manifest round-trip workflow in
  `references/cli.md`; pull the current Agent manifest/YAML first, edit it
  locally, and submit the complete updated config.
- Skill runtime requirements: inspect dependency manifests, imports, setup
  instructions, and missing-command or missing-module failures. Follow the
  `Skill Runtime Environment Workflow` in `references/cli.md` to select,
  create, copy, or update an App-local Environment, then bind its
  `environmentId` to the Agent before publishing or starting a new Session.
- App env file only: derive `MOSOO_API_BASE`, `MOSOO_AGENT_ID`, and
  `MOSOO_API_TOKEN` from the published Agent/API contract; do not create
  mosoo resources unless the user asked for that.
- Published Agent verification: use the public Thread API contract in
  `references/api.md` or the generated public-thread-api commands in
  `references/cli.md`.

## Rules

- Do not implement a replacement planner, tool runner, memory system, sandbox,
  model loop, lifecycle manager, or provider integration when the task is to use
  a mosoo Agent.
- Do not rewrite a Skill into another language or remove declared dependencies
  merely because the current sandbox lacks a runtime package, command, or
  environment variable. Configure the mosoo Environment first. Rewrite only
  when the user explicitly requests a port or dependency removal.
- Treat Environment as an App-local runtime template for packages, setup
  script, and runtime env vars. It does not contain the Agent's Skills, Files,
  or MCP servers, and its stored network policy is not currently an enforced
  sandbox-security guarantee.
- Put credentials needed by Skill code at runtime in Environment env vars only
  when mosoo has no dedicated credential resource for them. Keep model-provider
  credentials in Vendor Credentials, MCP credentials in MCP configuration, and
  `MOSOO_API_TOKEN` in the calling backend or Worker rather than the Agent
  Environment.
- Prefer machine-readable CLI output such as `--json` before making environment
  or auth decisions.
- Do not construct Agent config update payloads from memory or guessed fields.
  Preserve the existing manifest values unless the user explicitly asks to
  change them.