[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AVT7Z5RNAQHG7Q5VESASTV":3,"skill-same:01M7AVT7Z5RNAQHG7Q5VESASTV":112},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":50,"repositoryHtmlUrl":51,"repositoryHomepageUrl":6,"ownerHtmlUrl":52,"ownerBlogUrl":53,"ownerDescription":54,"updatedAt":55,"install":56,"resources":69},"01M7AVT7Z5RNAQHG7Q5VESASTV","omega-loops-cli",null,"Build, package, or smoke-test the Aimee\u002FOmega CLI.","swcstudiospace\u002Faimeecodes","swcstudiospace","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F192491759?v=4","01M7AVGY9HD2GXDY0H77EBGRGQ","@swcstudio'(space)","01M7AVGYAKRDHFDMPG97W4D5M2",1,"MIT","https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: omega-loops-cli\ndescription: \"Build, package, or smoke-test the Aimee\u002FOmega CLI.\"\nversion: 1.5.0\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [omega, omegaloops, cli, cargo, smoke, install, debug]\n    related_skills: [omega-loops-providers, omega-anda-pathways, omega-loops-agents, rust-cli-binary-rename, hermes-project-soul, ratatui-agent-tui]\n---\n\n# Omega Loops — CLI from source\n\nHow to **run the CLI against the working tree** without a release package. Current checkout: `\u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes` (older notes may still say `omegaloops`). **Do not assume the binary is `omega`.** Read `crates\u002F*\u002FCargo.toml` `[[bin]] name` (this tree is `aimee`; it has been `omega`). Same for crate prefixes (`aimee_*` \u002F `omega_*`) and the install script (`scripts\u002Fdev-aimee.sh`, not `dev-omega.sh`).\n\nDon't use for: provider\u002FOAuth wiring (`omega-loops-providers`), Anda\u002FKIP pathways (`omega-anda-pathways`), built-in agent\u002Ftemplate rewrites (`omega-loops-agents`), renaming the command (`rust-cli-binary-rename`), crate\u002Ffolder rebrand (`rust-workspace-rebrand`). DevPod\u002Fcodespace wrap lives here (`aimee pod` \u002F `--pod`). Do **not** invent Anda dTEE — it is not in this tree.\n\n## When to use\n\n- User wants to install, package, or keep the local CLI on PATH after source updates so they can type `aimee …`\n- Need to smoke-test subcommands after crate or `include_dir!` changes\n- `aimee` \u002F `omega` is missing from PATH, still points at a stale or dangling binary, or the checkout moved\n- Porting Hermes Agent loops (`\u002Fgoal`, SOUL.md, teams\u002Fworkflows, `\u002Flearn`, channels) into this Rust CLI\n\n## Install model (debug, not release)\n\nAGENTS.md: **never** `cargo build --release` unless the task is a release binary or a measured benchmark. Debug `target\u002Fdebug\u002Faimee` is ~800MB; do **not** `cargo install --path` (that copies the fat binary).\n\nCanonical loop (read `[[bin]]` + script name first):\n\n```bash\ncd \u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes\nscripts\u002Fdev-aimee.sh              # cargo build -p aimee_main + PATH shim + smoke\nscripts\u002Fdev-aimee.sh install      # force rebuild + ~\u002F.local\u002Fbin\u002Faimee symlink\nscripts\u002Fdev-aimee.sh sync         # rebuild only when sources or the link are stale\nscripts\u002Fdev-aimee.sh watch        # debounce + sync on crate\u002Ftemplate\u002Fplugin changes\nscripts\u002Fdev-aimee.sh smoke        # isolated AIMEE_CONFIG, no rebuild\n```\n\nWhat install does: `ln -sfn $REPO\u002Ftarget\u002Fdebug\u002Faimee ~\u002F.local\u002Fbin\u002Faimee`. Incremental `cargo build -p aimee_main` is enough. After crate or `include_dir!` edits (`templates\u002F`, `shell-plugin\u002Flib`), run `sync` — do not assume `target\u002Fdebug\u002Faimee` is current.\n\nNo-install: `.\u002Ftarget\u002Fdebug\u002Faimee \u003Cargs>`.\n\n**Keep PATH current after code updates** with `watch` (or the user systemd unit), not Hermes cron. Cron jobs have a 3-minute hard interrupt — cargo incremental can exceed that and die mid-link. systemd `PathChanged=` is not recursive, so it will miss `.rs` edits under `crates\u002F*`. Details: `references\u002Flocal-package-watch.md`.\n\n## Smoke vs porcelain dump\n\n| Script | Role |\n|--------|------|\n| `scripts\u002Fdev-aimee.sh` | Asserts exit 0 + key substrings. Isolated `AIMEE_CONFIG` temp dir. |\n| `scripts\u002Flist-all-porcelain.sh` | Visual dump of `list * --porcelain`. Not a gate. |\n| `scripts\u002Ftest-zsh-utils.sh` | Zsh `omega zsh format` e2e. Needs zsh. |\n| `scripts\u002Ftest-400-error-message.sh` | Live provider 400 body. Needs creds. |\n\nSmoke covers clap + non-interactive porcelain only: `--version`, `--help`, `provider --help`, `list --help`, `banner`, `info --porcelain`, `list {provider,agent,config,mcp,conversation,cmd,skill} --porcelain`, `workspace list --porcelain`, `conversation list --porcelain`.\n\n`--help` \u002F `--version` exit inside clap **before** config. Other subcommands call `AimeeConfig::read()` — defaults work with no real home. Set `AIMEE_CONFIG` to a temp dir so smoke never writes `~\u002F.forge`.\n\n`omega info --porcelain` uses `init_state` only (not `on_new`) to avoid hydrate-cache join panics on exit.\n\n## Procedure\n\n1. Confirm checkout + binary crate: `\u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes` `crates\u002Faimee_main` `[[bin]] name = \"aimee\"`.\n2. `scripts\u002Fdev-aimee.sh` (or `sync` \u002F `install` then a specific command).\n3. Done when `command -v aimee` is the symlink and `aimee --version` prints `0.1.0-dev`.\n4. After code changes, `sync` (or rely on `watch`). Do not assume `target\u002Fdebug\u002Faimee` is current.\n5. Hermes-port slash commands live in `{prefix}_domain` + `{prefix}_main` (`\u002Fgoal`, `\u002Fsoul`, `\u002Fteam run`, `\u002Flearn`, `\u002Fchannel`). See `references\u002Fhermes-port.md` and `references\u002Floop-autonomy.md`. `\u002Fgoal` requires **five HITL probes** before `set_loop`. Auto-continues on TaskComplete after the judge. `\u002Fteam run` advances muse→omega→sage before the goal loop. `\u002Fchannel poll` is one-shot `getUpdates`, not a 24\u002F7 gateway.\n6. DevPod is wrapped, not vendored (Go binary on PATH). Rebranded surface: `{bin} pod …` (aliases `codespace`, `devpod`). Session flag `--pod \u003Cid>` provisions a container **before** TUI; `--sandbox` stays a git worktree. `\u002Fgoal` stores `pod_id`; `\u002Fgoal pod` runs `devpod up --open-ide=false`; `\u002Fgoal exec \u003Ccmd>` → `devpod ssh --command`; `\u002Fgoal pr` → `gh pr create --fill`. Headless: `{bin} pod ui` \u002F `pod doctor` (Mac Mini SSH; no DevPod Desktop on this Linux host). See `references\u002Fdevpod-pod.md`.\n\n## Pitfalls\n\n- **Hermes cron to “package after every update”** — 3-minute hard interrupt kills cargo. Use `scripts\u002Fdev-aimee.sh watch` or the user unit `aimee-local-package.service`.\n- **systemd `PathChanged=` on `crates\u002F`** — not recursive; misses `.rs` edits. `inotifywait -r` + a quiet debounce (default 20s) is the watcher.\n- **Git hooks on this checkout** — `\u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes` may have no `.git`. Do not `git init`; use the file watcher. See `references\u002Frustyline-backtab-and-config-home.md`.\n- **Release “to package periodically”** — slow, unused for correctness, forbidden by AGENTS.md.\n- **`cargo install --path crates\u002Fomega_main --debug --force`** — copies ~800MB into `~\u002F.cargo\u002Fbin`. Symlink instead.\n- **Bare `omega` with no shim** — debug binary exists but is not on PATH until install.\n- **Claiming suite green** from smoke — 15 CLI checks ≠ `cargo insta test`. Say ad-hoc \u002F smoke.\n- **Interactive commands in smoke** — `select`, `provider login`, TUI `omega` with no args hang. Don't add them.\n- **`list-all-porcelain.sh` as a test** — it prints; it does not fail on wrong output.\n- **`writeln_title` while holding `&GoalState`** — `on_goal` must clone the label\u002Fcount first; otherwise E0502\u002FE0499.\n- **Channel files must never store bot tokens** — `~\u002F.omega\u002Fchannels.json` holds kind + address only.\n- **SOUL is extra custom instructions** — discover `cwd\u002FSOUL.md`, `cwd\u002FSOUL\u002FSOUL.md`, `~\u002F.omega\u002FSOUL.md`; do not replace `AGENTS.md`.\n- **Tick once per completed turn** — `tick()` lives in `maybe_continue_goal` (TaskComplete), not in the `Message` handler. Double-tick burns the 30-turn budget twice as fast.\n- **Workflow before goal** — `after_turn_loops` advances `\u002Fteam run` first; only then auto-continues `\u002Fgoal`.\n- **`Box::pin` for turn recursion** — `on_message` → TaskComplete → `dispatch_workflow_step` \u002F `maybe_continue_goal` → `on_message` is a self-call; compile fails without pin.\n- **Ignore rustfmt edition-2015 noise on `ui.rs`** — the file is edition 2024; `cargo check -p omega_main --bin omega` is the gate.\n- **`UIState` has no `Default`** after `GoalStore` \u002F `WorkflowRun` were added — always `UIState::new(env)`.\n- **Crate\u002Fbin rename mid-session** — `omega_*` may become `aimee_*` (bin `aimee`). `cargo test -p omega_domain` then fails with \"did not match any packages\". Re-read `[[bin]]` and `crates\u002F` before every verify.\n- **Five probes are mandatory on `\u002Fgoal`** — `GoalStore::set_loop`, not `set`. TTY: `collect_goal_probes`. Non-TTY: five `probe: …` lines or refuse.\n- **XML wrap every user turn** — `PromptUpgrade::wrap` on `AppCommand::Message`. Skip if `\u003Comega_prompt` already present. Structural envelope, not a second LLM call.\n- **Tool-failure default is unlimited** — `unwrap_or_else(unlimited_tool_failures)` (`usize::MAX`). Do not restore `unwrap_or(3)`. `ToolErrorTracker::new(0)` is not unlimited.\n- **Linear telemetry is fail-open** — POST `http:\u002F\u002F127.0.0.1:8792\u002Fv1\u002Fensure-issue` after prompts. Connector health ≠ issue filed. Linear MCP is the cockpit (`hermes-linear-kanban-sync`).\n- **Drop CoT×GoT is `.mcp.json`** — `http:\u002F\u002F127.0.0.1:7788\u002Fmcp`.\n- **Do not claim 95% coverage for the whole workspace** — `QualityPolicy` + `scripts\u002Ftdd-gate.sh` are the gate. Measure first.\n- **Git commit every prompt only if `.git` exists** — skip otherwise. `\u002Fgoal pr` is the PR path.\n- **Greptile pre-push** — `scripts\u002Fgreptile-pre-push.sh` exits 0 if the CLI is missing.\n- **CodeRabbit lives in `{prefix}_ci`** — `generate_coderabbit_workflow()` writes `.github\u002Fworkflows\u002Fcoderabbit.yml`. Edit the generator, not the YAML, when both exist.\n- **Do not invent Anda dTEE** — no type\u002Fcrate\u002FAPI in this repo. `pod doctor` must say missing; do not stub a TEE.\n- **Do not vendor DevPod Go into the Rust workspace** — wrap `devpod` via `std::process::Command`.\n- **`--sandbox` ≠ `--pod`** — git worktree vs DevPod container. Do not silently replace worktree with `devpod up`.\n- **Clap about strings must not say DevPod** — `aimee pod --help` is Aimee-branded. Hidden alias `devpod` is fine; user-facing `\u002F\u002F\u002F` comments are not. Gate: `test_pod_help_is_aimee_branded`.\n- **`.devcontainer` postCreate must use `cargo install --locked cargo-nextest`** — unlocked source install fails with `locked-tripwire` and `aimee pod up` exits 1. Hook lives in `.devcontainer\u002Fpost-create.sh`.\n- **Shift+Tab cycles approval** — Confirm → Auto → Yolo (`ApprovalMode` in `aimee_domain`). Auto\u002FYolo skip permission prompts and the “continue anyway?” interrupt. Default is Yolo (matches unrestricted config).\n- **`\u002Fswarm \u003Ctext>` starts `\u002Fgoal`** — same five probes, then the swarm template; the standing loop continues until the judge completes.\n- **Do not PyO3-import Hermes tools** — Hermes is already cloned; load `~\u002F.hermes\u002Fskills` (depth 3) via `hermes_skills_path`. Skill authoring is `\u002Flearn`, not a dump of Python tools into the Rust catalog.\n- **Secrets pasted in chat** — write `~\u002F.config\u002Faimee\u002Fsecrets.env` mode 600 (`LINEAR_API_KEY`, `GREPTILE_API_KEY`); `load_aimee_secrets()` at startup; never commit. Tell the user to rotate.\n- See `references\u002Fpod-devcontainer-and-approval.md`.\n- **xAI SuperGrok `\u002Fmodels`** can include Imagine `pricing` as an **array**; tolerate it or SuperGrok vanishes. One dead sibling (Anthropic 401) must not abort `get_all_provider_models`. See `omega-loops-providers`.\n\n## Verification\n\n```bash\ncd \u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes\nbash -n scripts\u002Fdev-aimee.sh\nscripts\u002Fdev-aimee.sh\naimee --version    # 0.1.0-dev\nreadlink -f \"$(command -v aimee)\"   # …\u002Faimeecodes\u002Ftarget\u002Fdebug\u002Faimee\nsystemctl --user is-active aimee-local-package.service   # when watch should be durable\n```\n\nExpect **19 passed** from `dev-aimee.sh` smoke (15 clap\u002Fporcelain + pod help\u002Fdoctor). Ad-hoc extra checks go in `\u002Ftmp\u002Fhermes-verify-*.sh` and get deleted.\n\n## References\n\n- `references\u002Flocal-package-watch.md` — debug symlink, `sync`\u002F`watch`, systemd unit, why not Hermes cron\n- `references\u002Fsmoke-commands.md` — exact smoke argv + expected needles\n- Repo script: `scripts\u002Fdev-aimee.sh`\n- `references\u002Fhermes-port.md` — `\u002Fgoal` auto-continue + judge, `\u002Fteam run`, SOUL, `\u002Flearn`, channels send\u002Fpoll\n- `references\u002Floop-autonomy.md` — five probes, XML upgrade, Linear :8792, Drop MCP, TDD\u002FGreptile\u002FCodeRabbit\n- `references\u002Fdevpod-pod.md` — DevPod wrap, `\u002Fgoal pod|exec|pr`, `--pod` vs `--sandbox`, Mac Mini SSH, dTEE not in tree\n- `references\u002Fpod-devcontainer-and-approval.md` — clap branding, nextest `--locked`, Shift+Tab YOLO, `\u002Fswarm`→`\u002Fgoal`, Hermes skills load, secrets.env\n- Repo script: `scripts\u002Fdev-omega.sh`\n- Config isolation: `OMEGA_CONFIG` → `ConfigReader::resolve_base_path`\n","# Omega Loops — CLI from source\n\nHow to **run the CLI against the working tree** without a release package. Current checkout: `\u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes` (older notes may still say `omegaloops`). **Do not assume the binary is `omega`.** Read `crates\u002F*\u002FCargo.toml` `[[bin]] name` (this tree is `aimee`; it has been `omega`). Same for crate prefixes (`aimee_*` \u002F `omega_*`) and the install script (`scripts\u002Fdev-aimee.sh`, not `dev-omega.sh`).\n\nDon't use for: provider\u002FOAuth wiring (`omega-loops-providers`), Anda\u002FKIP pathways (`omega-anda-pathways`), built-in agent\u002Ftemplate rewrites (`omega-loops-agents`), renaming the command (`rust-cli-binary-rename`), crate\u002Ffolder rebrand (`rust-workspace-rebrand`). DevPod\u002Fcodespace wrap lives here (`aimee pod` \u002F `--pod`). Do **not** invent Anda dTEE — it is not in this tree.\n\n## When to use\n\n- User wants to install, package, or keep the local CLI on PATH after source updates so they can type `aimee …`\n- Need to smoke-test subcommands after crate or `include_dir!` changes\n- `aimee` \u002F `omega` is missing from PATH, still points at a stale or dangling binary, or the checkout moved\n- Porting Hermes Agent loops (`\u002Fgoal`, SOUL.md, teams\u002Fworkflows, `\u002Flearn`, channels) into this Rust CLI\n\n## Install model (debug, not release)\n\nAGENTS.md: **never** `cargo build --release` unless the task is a release binary or a measured benchmark. Debug `target\u002Fdebug\u002Faimee` is ~800MB; do **not** `cargo install --path` (that copies the fat binary).\n\nCanonical loop (read `[[bin]]` + script name first):\n\n```bash\ncd \u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes\nscripts\u002Fdev-aimee.sh              # cargo build -p aimee_main + PATH shim + smoke\nscripts\u002Fdev-aimee.sh install      # force rebuild + ~\u002F.local\u002Fbin\u002Faimee symlink\nscripts\u002Fdev-aimee.sh sync         # rebuild only when sources or the link are stale\nscripts\u002Fdev-aimee.sh watch        # debounce + sync on crate\u002Ftemplate\u002Fplugin changes\nscripts\u002Fdev-aimee.sh smoke        # isolated AIMEE_CONFIG, no rebuild\n```\n\nWhat install does: `ln -sfn $REPO\u002Ftarget\u002Fdebug\u002Faimee ~\u002F.local\u002Fbin\u002Faimee`. Incremental `cargo build -p aimee_main` is enough. After crate or `include_dir!` edits (`templates\u002F`, `shell-plugin\u002Flib`), run `sync` — do not assume `target\u002Fdebug\u002Faimee` is current.\n\nNo-install: `.\u002Ftarget\u002Fdebug\u002Faimee \u003Cargs>`.\n\n**Keep PATH current after code updates** with `watch` (or the user systemd unit), not Hermes cron. Cron jobs have a 3-minute hard interrupt — cargo incremental can exceed that and die mid-link. systemd `PathChanged=` is not recursive, so it will miss `.rs` edits under `crates\u002F*`. Details: `references\u002Flocal-package-watch.md`.\n\n## Smoke vs porcelain dump\n\n| Script | Role |\n|--------|------|\n| `scripts\u002Fdev-aimee.sh` | Asserts exit 0 + key substrings. Isolated `AIMEE_CONFIG` temp dir. |\n| `scripts\u002Flist-all-porcelain.sh` | Visual dump of `list * --porcelain`. Not a gate. |\n| `scripts\u002Ftest-zsh-utils.sh` | Zsh `omega zsh format` e2e. Needs zsh. |\n| `scripts\u002Ftest-400-error-message.sh` | Live provider 400 body. Needs creds. |\n\nSmoke covers clap + non-interactive porcelain only: `--version`, `--help`, `provider --help`, `list --help`, `banner`, `info --porcelain`, `list {provider,agent,config,mcp,conversation,cmd,skill} --porcelain`, `workspace list --porcelain`, `conversation list --porcelain`.\n\n`--help` \u002F `--version` exit inside clap **before** config. Other subcommands call `AimeeConfig::read()` — defaults work with no real home. Set `AIMEE_CONFIG` to a temp dir so smoke never writes `~\u002F.forge`.\n\n`omega info --porcelain` uses `init_state` only (not `on_new`) to avoid hydrate-cache join panics on exit.\n\n## Procedure\n\n1. Confirm checkout + binary crate: `\u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes` `crates\u002Faimee_main` `[[bin]] name = \"aimee\"`.\n2. `scripts\u002Fdev-aimee.sh` (or `sync` \u002F `install` then a specific command).\n3. Done when `command -v aimee` is the symlink and `aimee --version` prints `0.1.0-dev`.\n4. After code changes, `sync` (or rely on `watch`). Do not assume `target\u002Fdebug\u002Faimee` is current.\n5. Hermes-port slash commands live in `{prefix}_domain` + `{prefix}_main` (`\u002Fgoal`, `\u002Fsoul`, `\u002Fteam run`, `\u002Flearn`, `\u002Fchannel`). See `references\u002Fhermes-port.md` and `references\u002Floop-autonomy.md`. `\u002Fgoal` requires **five HITL probes** before `set_loop`. Auto-continues on TaskComplete after the judge. `\u002Fteam run` advances muse→omega→sage before the goal loop. `\u002Fchannel poll` is one-shot `getUpdates`, not a 24\u002F7 gateway.\n6. DevPod is wrapped, not vendored (Go binary on PATH). Rebranded surface: `{bin} pod …` (aliases `codespace`, `devpod`). Session flag `--pod \u003Cid>` provisions a container **before** TUI; `--sandbox` stays a git worktree. `\u002Fgoal` stores `pod_id`; `\u002Fgoal pod` runs `devpod up --open-ide=false`; `\u002Fgoal exec \u003Ccmd>` → `devpod ssh --command`; `\u002Fgoal pr` → `gh pr create --fill`. Headless: `{bin} pod ui` \u002F `pod doctor` (Mac Mini SSH; no DevPod Desktop on this Linux host). See `references\u002Fdevpod-pod.md`.\n\n## Pitfalls\n\n- **Hermes cron to “package after every update”** — 3-minute hard interrupt kills cargo. Use `scripts\u002Fdev-aimee.sh watch` or the user unit `aimee-local-package.service`.\n- **systemd `PathChanged=` on `crates\u002F`** — not recursive; misses `.rs` edits. `inotifywait -r` + a quiet debounce (default 20s) is the watcher.\n- **Git hooks on this checkout** — `\u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes` may have no `.git`. Do not `git init`; use the file watcher. See `references\u002Frustyline-backtab-and-config-home.md`.\n- **Release “to package periodically”** — slow, unused for correctness, forbidden by AGENTS.md.\n- **`cargo install --path crates\u002Fomega_main --debug --force`** — copies ~800MB into `~\u002F.cargo\u002Fbin`. Symlink instead.\n- **Bare `omega` with no shim** — debug binary exists but is not on PATH until install.\n- **Claiming suite green** from smoke — 15 CLI checks ≠ `cargo insta test`. Say ad-hoc \u002F smoke.\n- **Interactive commands in smoke** — `select`, `provider login`, TUI `omega` with no args hang. Don't add them.\n- **`list-all-porcelain.sh` as a test** — it prints; it does not fail on wrong output.\n- **`writeln_title` while holding `&GoalState`** — `on_goal` must clone the label\u002Fcount first; otherwise E0502\u002FE0499.\n- **Channel files must never store bot tokens** — `~\u002F.omega\u002Fchannels.json` holds kind + address only.\n- **SOUL is extra custom instructions** — discover `cwd\u002FSOUL.md`, `cwd\u002FSOUL\u002FSOUL.md`, `~\u002F.omega\u002FSOUL.md`; do not replace `AGENTS.md`.\n- **Tick once per completed turn** — `tick()` lives in `maybe_continue_goal` (TaskComplete), not in the `Message` handler. Double-tick burns the 30-turn budget twice as fast.\n- **Workflow before goal** — `after_turn_loops` advances `\u002Fteam run` first; only then auto-continues `\u002Fgoal`.\n- **`Box::pin` for turn recursion** — `on_message` → TaskComplete → `dispatch_workflow_step` \u002F `maybe_continue_goal` → `on_message` is a self-call; compile fails without pin.\n- **Ignore rustfmt edition-2015 noise on `ui.rs`** — the file is edition 2024; `cargo check -p omega_main --bin omega` is the gate.\n- **`UIState` has no `Default`** after `GoalStore` \u002F `WorkflowRun` were added — always `UIState::new(env)`.\n- **Crate\u002Fbin rename mid-session** — `omega_*` may become `aimee_*` (bin `aimee`). `cargo test -p omega_domain` then fails with \"did not match any packages\". Re-read `[[bin]]` and `crates\u002F` before every verify.\n- **Five probes are mandatory on `\u002Fgoal`** — `GoalStore::set_loop`, not `set`. TTY: `collect_goal_probes`. Non-TTY: five `probe: …` lines or refuse.\n- **XML wrap every user turn** — `PromptUpgrade::wrap` on `AppCommand::Message`. Skip if `\u003Comega_prompt` already present. Structural envelope, not a second LLM call.\n- **Tool-failure default is unlimited** — `unwrap_or_else(unlimited_tool_failures)` (`usize::MAX`). Do not restore `unwrap_or(3)`. `ToolErrorTracker::new(0)` is not unlimited.\n- **Linear telemetry is fail-open** — POST `http:\u002F\u002F127.0.0.1:8792\u002Fv1\u002Fensure-issue` after prompts. Connector health ≠ issue filed. Linear MCP is the cockpit (`hermes-linear-kanban-sync`).\n- **Drop CoT×GoT is `.mcp.json`** — `http:\u002F\u002F127.0.0.1:7788\u002Fmcp`.\n- **Do not claim 95% coverage for the whole workspace** — `QualityPolicy` + `scripts\u002Ftdd-gate.sh` are the gate. Measure first.\n- **Git commit every prompt only if `.git` exists** — skip otherwise. `\u002Fgoal pr` is the PR path.\n- **Greptile pre-push** — `scripts\u002Fgreptile-pre-push.sh` exits 0 if the CLI is missing.\n- **CodeRabbit lives in `{prefix}_ci`** — `generate_coderabbit_workflow()` writes `.github\u002Fworkflows\u002Fcoderabbit.yml`. Edit the generator, not the YAML, when both exist.\n- **Do not invent Anda dTEE** — no type\u002Fcrate\u002FAPI in this repo. `pod doctor` must say missing; do not stub a TEE.\n- **Do not vendor DevPod Go into the Rust workspace** — wrap `devpod` via `std::process::Command`.\n- **`--sandbox` ≠ `--pod`** — git worktree vs DevPod container. Do not silently replace worktree with `devpod up`.\n- **Clap about strings must not say DevPod** — `aimee pod --help` is Aimee-branded. Hidden alias `devpod` is fine; user-facing `\u002F\u002F\u002F` comments are not. Gate: `test_pod_help_is_aimee_branded`.\n- **`.devcontainer` postCreate must use `cargo install --locked cargo-nextest`** — unlocked source install fails with `locked-tripwire` and `aimee pod up` exits 1. Hook lives in `.devcontainer\u002Fpost-create.sh`.\n- **Shift+Tab cycles approval** — Confirm → Auto → Yolo (`ApprovalMode` in `aimee_domain`). Auto\u002FYolo skip permission prompts and the “continue anyway?” interrupt. Default is Yolo (matches unrestricted config).\n- **`\u002Fswarm \u003Ctext>` starts `\u002Fgoal`** — same five probes, then the swarm template; the standing loop continues until the judge completes.\n- **Do not PyO3-import Hermes tools** — Hermes is already cloned; load `~\u002F.hermes\u002Fskills` (depth 3) via `hermes_skills_path`. Skill authoring is `\u002Flearn`, not a dump of Python tools into the Rust catalog.\n- **Secrets pasted in chat** — write `~\u002F.config\u002Faimee\u002Fsecrets.env` mode 600 (`LINEAR_API_KEY`, `GREPTILE_API_KEY`); `load_aimee_secrets()` at startup; never commit. Tell the user to rotate.\n- See `references\u002Fpod-devcontainer-and-approval.md`.\n- **xAI SuperGrok `\u002Fmodels`** can include Imagine `pricing` as an **array**; tolerate it or SuperGrok vanishes. One dead sibling (Anthropic 401) must not abort `get_all_provider_models`. See `omega-loops-providers`.\n\n## Verification\n\n```bash\ncd \u002Froot\u002Fsrc\u002Frepos\u002Faimeecodes\nbash -n scripts\u002Fdev-aimee.sh\nscripts\u002Fdev-aimee.sh\naimee --version    # 0.1.0-dev\nreadlink -f \"$(command -v aimee)\"   # …\u002Faimeecodes\u002Ftarget\u002Fdebug\u002Faimee\nsystemctl --user is-active aimee-local-package.service   # when watch should be durable\n```\n\nExpect **19 passed** from `dev-aimee.sh` smoke (15 clap\u002Fporcelain + pod help\u002Fdoctor). Ad-hoc extra checks go in `\u002Ftmp\u002Fhermes-verify-*.sh` and get deleted.\n\n## References\n\n- `references\u002Flocal-package-watch.md` — debug symlink, `sync`\u002F`watch`, systemd unit, why not Hermes cron\n- `references\u002Fsmoke-commands.md` — exact smoke argv + expected needles\n- Repo script: `scripts\u002Fdev-aimee.sh`\n- `references\u002Fhermes-port.md` — `\u002Fgoal` auto-continue + judge, `\u002Fteam run`, SOUL, `\u002Flearn`, channels send\u002Fpoll\n- `references\u002Floop-autonomy.md` — five probes, XML upgrade, Linear :8792, Drop MCP, TDD\u002FGreptile\u002FCodeRabbit\n- `references\u002Fdevpod-pod.md` — DevPod wrap, `\u002Fgoal pod|exec|pr`, `--pod` vs `--sandbox`, Mac Mini SSH, dTEE not in tree\n- `references\u002Fpod-devcontainer-and-approval.md` — clap branding, nextest `--locked`, Shift+Tab YOLO, `\u002Fswarm`→`\u002Fgoal`, Hermes skills load, secrets.env\n- Repo script: `scripts\u002Fdev-omega.sh`\n- Config isolation: `OMEGA_CONFIG` → `ConfigReader::resolve_base_path`\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":43,"description":7},"Hermes Agent","1.5.0",{"hermes":27},{"tags":28,"related_skills":36},[29,30,31,32,33,34,35],"omega","omegaloops","cli","cargo","smoke","install","debug",[37,38,39,40,41,42],"omega-loops-providers","omega-anda-pathways","omega-loops-agents","rust-cli-binary-rename","hermes-project-soul","ratatui-agent-tui",[44,45,46],"linux","macos","windows","main","1532f6e28b7d7cc5ae38dfe70c4e886157e8f01e",".aimee\u002Fskills\u002Fomega-loops-cli",0,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes","https:\u002F\u002Fgithub.com\u002Fswcstudiospace","https:\u002F\u002Fwww.swcstudio.space\u002F","APAC's premier WEB3.ARL Studio for programming advanced best-in-class innovations'","2026-11-11 21:45:42",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add swcstudiospace\u002Faimeecodes --skill omega-loops-cli",{"tool":62,"command":63},"bunx","bunx skills add swcstudiospace\u002Faimeecodes --skill omega-loops-cli",{"tool":65,"command":66},"pnpm","pnpm dlx skills add swcstudiospace\u002Faimeecodes --skill omega-loops-cli","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002FSKILL.md",true,[70,76,80,84,88,92,96,100,104,108],{"path":71,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Faimee-cli-ux.md","REFERENCE","参考文档",2272,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Faimee-cli-ux.md",{"path":77,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fconfig-home-and-session.md",963,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Fconfig-home-and-session.md",{"path":81,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fdevpod-pod.md",1290,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Fdevpod-pod.md",{"path":85,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fdevpod-wrap.md",1357,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Fdevpod-wrap.md",{"path":89,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Fhermes-port.md",5000,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Fhermes-port.md",{"path":93,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":94,"sourceHtmlUrl":95},"references\u002Flocal-package-watch.md",1927,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Flocal-package-watch.md",{"path":97,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":98,"sourceHtmlUrl":99},"references\u002Floop-autonomy.md",2469,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Floop-autonomy.md",{"path":101,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":102,"sourceHtmlUrl":103},"references\u002Fpod-devcontainer-and-approval.md",1551,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Fpod-devcontainer-and-approval.md",{"path":105,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":106,"sourceHtmlUrl":107},"references\u002Frustyline-backtab-and-config-home.md",898,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Frustyline-backtab-and-config-home.md",{"path":109,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":110,"sourceHtmlUrl":111},"references\u002Fsmoke-commands.md",1090,"https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fomega-loops-cli\u002Freferences\u002Fsmoke-commands.md",[113,120,127,134,141,148],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":19},"01M7AW01SRKZDGAMSENA2KKV1C","xurl","X\u002FTwitter via xurl CLI: raw post search, posting, DM, media.","https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":121,"name":122,"nameZh":6,"description":123,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":124,"categories":125,"keywords":126,"publishedAt":19},"01M7AVZKD3FMV3ZPX50DY7XZZR","weights-and-biases","W&B: log ML experiments, sweeps, model registry, dashboards.","https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fweights-and-biases\u002FSKILL.md",[],[],{"skillNo":128,"name":129,"nameZh":6,"description":130,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":131,"categories":132,"keywords":133,"publishedAt":19},"01M7AVZEY5AS893YVWYY4DFQKK","touchdesigner-mcp","Control TouchDesigner via twozero MCP.","https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":135,"name":136,"nameZh":6,"description":137,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":138,"categories":139,"keywords":140,"publishedAt":19},"01M7AVZ4K45X76C09FQQMC9GH0","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":142,"name":143,"nameZh":6,"description":144,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":145,"categories":146,"keywords":147,"publishedAt":19},"01M7AVZ029D94C9HNET2TYTHNZ","technical-docs-corpora","Use when bulk-crawling public tech docs into agent skills.","https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Ftechnical-docs-corpora\u002FSKILL.md",[],[],{"skillNo":149,"name":150,"nameZh":6,"description":151,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":152,"categories":153,"keywords":154,"publishedAt":19},"01M7AVYTXSJWYYD7GZMTTR9BC0","teams-meeting-pipeline","Teams meeting summaries, job replay, Graph subscriptions.","https:\u002F\u002Fgithub.com\u002Fswcstudiospace\u002Faimeecodes\u002Fblob\u002Fmain\u002F.aimee\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[]]