omega-loops-cli
Build, package, or smoke-test the Aimee/Omega CLI.
- License 许可
- MIT
- 最近更新
- 2026-11-11
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- omega-loops-cli
- author
- Hermes Agent
- license
- MIT
- version
- 1.5.0
- metadata
- { "hermes": { "tags": [ "omega", "omegaloops", "cli", "cargo", "smoke", "install", "debug" ], "related_skills": [ "omega-loops-providers", "omega-anda-pathways", "omega-loops-agents", "rust-cli-binary-rename", "hermes-project-soul", "ratatui-agent-tui" ] } }
- platforms
- [ "linux", "macos", "windows" ]
- description
- Build, package, or smoke-test the Aimee/Omega CLI.
02 资源文件 10
- 参考文档references/aimee-cli-ux.md2.2 KB
- 参考文档references/config-home-and-session.md963 B
- 参考文档references/devpod-pod.md1.3 KB
- 参考文档references/devpod-wrap.md1.3 KB
- 参考文档references/hermes-port.md4.9 KB
- 参考文档references/local-package-watch.md1.9 KB
- 参考文档references/loop-autonomy.md2.4 KB
- 参考文档references/pod-devcontainer-and-approval.md1.5 KB
- 参考文档references/rustyline-backtab-and-config-home.md898 B
- 参考文档references/smoke-commands.md1.1 KB
03 SKILL.md 正文
Omega Loops — CLI from source
How to run the CLI against the working tree without a release package. Current checkout: /root/src/repos/aimeecodes (older notes may still say omegaloops). Do not assume the binary is omega. Read crates/*/Cargo.toml [[bin]] name (this tree is aimee; it has been omega). Same for crate prefixes (aimee_* / omega_*) and the install script (scripts/dev-aimee.sh, not dev-omega.sh).
Don't use for: provider/OAuth wiring (omega-loops-providers), Anda/KIP pathways (omega-anda-pathways), built-in agent/template rewrites (omega-loops-agents), renaming the command (rust-cli-binary-rename), crate/folder rebrand (rust-workspace-rebrand). DevPod/codespace wrap lives here (aimee pod / --pod). Do not invent Anda dTEE — it is not in this tree.
When to use
- User wants to install, package, or keep the local CLI on PATH after source updates so they can type
aimee … - Need to smoke-test subcommands after crate or
include_dir!changes aimee/omegais missing from PATH, still points at a stale or dangling binary, or the checkout moved- Porting Hermes Agent loops (
/goal, SOUL.md, teams/workflows,/learn, channels) into this Rust CLI
Install model (debug, not release)
AGENTS.md: never cargo build --release unless the task is a release binary or a measured benchmark. Debug target/debug/aimee is ~800MB; do not cargo install --path (that copies the fat binary).
Canonical loop (read [[bin]] + script name first):
cd /root/src/repos/aimeecodes
scripts/dev-aimee.sh # cargo build -p aimee_main + PATH shim + smoke
scripts/dev-aimee.sh install # force rebuild + ~/.local/bin/aimee symlink
scripts/dev-aimee.sh sync # rebuild only when sources or the link are stale
scripts/dev-aimee.sh watch # debounce + sync on crate/template/plugin changes
scripts/dev-aimee.sh smoke # isolated AIMEE_CONFIG, no rebuild
What install does: ln -sfn $REPO/target/debug/aimee ~/.local/bin/aimee. Incremental cargo build -p aimee_main is enough. After crate or include_dir! edits (templates/, shell-plugin/lib), run sync — do not assume target/debug/aimee is current.
No-install: ./target/debug/aimee <args>.
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/*. Details: references/local-package-watch.md.
Smoke vs porcelain dump
| Script | Role |
|---|---|
scripts/dev-aimee.sh |
Asserts exit 0 + key substrings. Isolated AIMEE_CONFIG temp dir. |
scripts/list-all-porcelain.sh |
Visual dump of list * --porcelain. Not a gate. |
scripts/test-zsh-utils.sh |
Zsh omega zsh format e2e. Needs zsh. |
scripts/test-400-error-message.sh |
Live provider 400 body. Needs creds. |
Smoke 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.
--help / --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 ~/.forge.
omega info --porcelain uses init_state only (not on_new) to avoid hydrate-cache join panics on exit.
Procedure
- Confirm checkout + binary crate:
/root/src/repos/aimeecodescrates/aimee_main[[bin]] name = "aimee". scripts/dev-aimee.sh(orsync/installthen a specific command).- Done when
command -v aimeeis the symlink andaimee --versionprints0.1.0-dev. - After code changes,
sync(or rely onwatch). Do not assumetarget/debug/aimeeis current. - Hermes-port slash commands live in
{prefix}_domain+{prefix}_main(/goal,/soul,/team run,/learn,/channel). Seereferences/hermes-port.mdandreferences/loop-autonomy.md./goalrequires five HITL probes beforeset_loop. Auto-continues on TaskComplete after the judge./team runadvances muse→omega→sage before the goal loop./channel pollis one-shotgetUpdates, not a 24/7 gateway. - DevPod is wrapped, not vendored (Go binary on PATH). Rebranded surface:
{bin} pod …(aliasescodespace,devpod). Session flag--pod <id>provisions a container before TUI;--sandboxstays a git worktree./goalstorespod_id;/goal podrunsdevpod up --open-ide=false;/goal exec <cmd>→devpod ssh --command;/goal pr→gh pr create --fill. Headless:{bin} pod ui/pod doctor(Mac Mini SSH; no DevPod Desktop on this Linux host). Seereferences/devpod-pod.md.
Pitfalls
- Hermes cron to “package after every update” — 3-minute hard interrupt kills cargo. Use
scripts/dev-aimee.sh watchor the user unitaimee-local-package.service. - systemd
PathChanged=oncrates/— not recursive; misses.rsedits.inotifywait -r+ a quiet debounce (default 20s) is the watcher. - Git hooks on this checkout —
/root/src/repos/aimeecodesmay have no.git. Do notgit init; use the file watcher. Seereferences/rustyline-backtab-and-config-home.md. - Release “to package periodically” — slow, unused for correctness, forbidden by AGENTS.md.
cargo install --path crates/omega_main --debug --force— copies ~800MB into~/.cargo/bin. Symlink instead.- Bare
omegawith no shim — debug binary exists but is not on PATH until install. - Claiming suite green from smoke — 15 CLI checks ≠
cargo insta test. Say ad-hoc / smoke. - Interactive commands in smoke —
select,provider login, TUIomegawith no args hang. Don't add them. list-all-porcelain.shas a test — it prints; it does not fail on wrong output.writeln_titlewhile holding&GoalState—on_goalmust clone the label/count first; otherwise E0502/E0499.- Channel files must never store bot tokens —
~/.omega/channels.jsonholds kind + address only. - SOUL is extra custom instructions — discover
cwd/SOUL.md,cwd/SOUL/SOUL.md,~/.omega/SOUL.md; do not replaceAGENTS.md. - Tick once per completed turn —
tick()lives inmaybe_continue_goal(TaskComplete), not in theMessagehandler. Double-tick burns the 30-turn budget twice as fast. - Workflow before goal —
after_turn_loopsadvances/team runfirst; only then auto-continues/goal. Box::pinfor turn recursion —on_message→ TaskComplete →dispatch_workflow_step/maybe_continue_goal→on_messageis a self-call; compile fails without pin.- Ignore rustfmt edition-2015 noise on
ui.rs— the file is edition 2024;cargo check -p omega_main --bin omegais the gate. UIStatehas noDefaultafterGoalStore/WorkflowRunwere added — alwaysUIState::new(env).- Crate/bin rename mid-session —
omega_*may becomeaimee_*(binaimee).cargo test -p omega_domainthen fails with "did not match any packages". Re-read[[bin]]andcrates/before every verify. - Five probes are mandatory on
/goal—GoalStore::set_loop, notset. TTY:collect_goal_probes. Non-TTY: fiveprobe: …lines or refuse. - XML wrap every user turn —
PromptUpgrade::wraponAppCommand::Message. Skip if<omega_promptalready present. Structural envelope, not a second LLM call. - Tool-failure default is unlimited —
unwrap_or_else(unlimited_tool_failures)(usize::MAX). Do not restoreunwrap_or(3).ToolErrorTracker::new(0)is not unlimited. - Linear telemetry is fail-open — POST
http://127.0.0.1:8792/v1/ensure-issueafter prompts. Connector health ≠ issue filed. Linear MCP is the cockpit (hermes-linear-kanban-sync). - Drop CoT×GoT is
.mcp.json—http://127.0.0.1:7788/mcp. - Do not claim 95% coverage for the whole workspace —
QualityPolicy+scripts/tdd-gate.share the gate. Measure first. - Git commit every prompt only if
.gitexists — skip otherwise./goal pris the PR path. - Greptile pre-push —
scripts/greptile-pre-push.shexits 0 if the CLI is missing. - CodeRabbit lives in
{prefix}_ci—generate_coderabbit_workflow()writes.github/workflows/coderabbit.yml. Edit the generator, not the YAML, when both exist. - Do not invent Anda dTEE — no type/crate/API in this repo.
pod doctormust say missing; do not stub a TEE. - Do not vendor DevPod Go into the Rust workspace — wrap
devpodviastd::process::Command. --sandbox≠--pod— git worktree vs DevPod container. Do not silently replace worktree withdevpod up.- Clap about strings must not say DevPod —
aimee pod --helpis Aimee-branded. Hidden aliasdevpodis fine; user-facing///comments are not. Gate:test_pod_help_is_aimee_branded. .devcontainerpostCreate must usecargo install --locked cargo-nextest— unlocked source install fails withlocked-tripwireandaimee pod upexits 1. Hook lives in.devcontainer/post-create.sh.- Shift+Tab cycles approval — Confirm → Auto → Yolo (
ApprovalModeinaimee_domain). Auto/Yolo skip permission prompts and the “continue anyway?” interrupt. Default is Yolo (matches unrestricted config). /swarm <text>starts/goal— same five probes, then the swarm template; the standing loop continues until the judge completes.- Do not PyO3-import Hermes tools — Hermes is already cloned; load
~/.hermes/skills(depth 3) viahermes_skills_path. Skill authoring is/learn, not a dump of Python tools into the Rust catalog. - Secrets pasted in chat — write
~/.config/aimee/secrets.envmode 600 (LINEAR_API_KEY,GREPTILE_API_KEY);load_aimee_secrets()at startup; never commit. Tell the user to rotate. - See
references/pod-devcontainer-and-approval.md. - xAI SuperGrok
/modelscan include Imaginepricingas an array; tolerate it or SuperGrok vanishes. One dead sibling (Anthropic 401) must not abortget_all_provider_models. Seeomega-loops-providers.
Verification
cd /root/src/repos/aimeecodes
bash -n scripts/dev-aimee.sh
scripts/dev-aimee.sh
aimee --version # 0.1.0-dev
readlink -f "$(command -v aimee)" # …/aimeecodes/target/debug/aimee
systemctl --user is-active aimee-local-package.service # when watch should be durable
Expect 19 passed from dev-aimee.sh smoke (15 clap/porcelain + pod help/doctor). Ad-hoc extra checks go in /tmp/hermes-verify-*.sh and get deleted.
References
references/local-package-watch.md— debug symlink,sync/watch, systemd unit, why not Hermes cronreferences/smoke-commands.md— exact smoke argv + expected needles- Repo script:
scripts/dev-aimee.sh references/hermes-port.md—/goalauto-continue + judge,/team run, SOUL,/learn, channels send/pollreferences/loop-autonomy.md— five probes, XML upgrade, Linear :8792, Drop MCP, TDD/Greptile/CodeRabbitreferences/devpod-pod.md— DevPod wrap,/goal pod|exec|pr,--podvs--sandbox, Mac Mini SSH, dTEE not in treereferences/pod-devcontainer-and-approval.md— clap branding, nextest--locked, Shift+Tab YOLO,/swarm→/goal, Hermes skills load, secrets.env- Repo script:
scripts/dev-omega.sh - Config isolation:
OMEGA_CONFIG→ConfigReader::resolve_base_path
04 同仓库更多 Skills
xurl
X/Twitter via xurl CLI: raw post search, posting, DM, media.
weights-and-biases
W&B: log ML experiments, sweeps, model registry, dashboards.
touchdesigner-mcp
Control TouchDesigner via twozero MCP.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
technical-docs-corpora
Use when bulk-crawling public tech docs into agent skills.
teams-meeting-pipeline
Teams meeting summaries, job replay, Graph subscriptions.