Skip to content

denghongcai/Operon / skills/operon-fs-exec

operon-fs-execs

Verified

Use when an agent needs to read, write, copy, remove, or mount remote files, or run and interact with execs on Operon nodes.

FileKindSize
SKILL.mdskill md2.7 KB
---
name: operon-fs-execs
description: Use when an agent needs to read, write, copy, remove, or mount remote files, or run and interact with execs on Operon nodes.
---

# Operon FS And Execs

Use this skill for filesystem and process execution workflows. Graph steps use
`exec.run` for non-interactive execution. Filesystem targets use `node:/path`
form. Always inspect the exact command help before running a command:

```bash
operon fs --help
operon fs read --help
operon fs write --help
operon exec run --help
operon exec session --help
operon exec logs --help
operon exec stdin --help
```

Filesystem command choice:

- Inspect metadata: `operon fs stat <node:/path>`.
- List a directory: `operon fs list <node:/path>`.
- Stream a remote file: `operon fs read <node:/path>`.
- Write inline content or a local file: `operon fs write <node:/path>`.
- Create a directory: `operon fs mkdir <node:/path>`.
- Copy: `operon fs copy <node:/from> <node:/to>`.
- Rename or move: `operon fs rename <node:/from> <node:/to>`.
- Truncate: `operon fs truncate <node:/path> --size <bytes>`.
- Remove: `operon fs rm <node:/path>`.
- Linux local mount: `operon mount <node:/path> --to <mountpoint>`.

For parallel mount reads, inspect `operon mount --help` for Linux worker count
and cross-platform in-flight read/byte-budget overrides. Tune from matched ops/s
measurements; same-file reads can share the kernel cache. On slow private links,
configure the RPC deadline or use `--rpc-timeout-secs`; read queue waiting counts
against that deadline. Do not disable audit or containment to improve throughput.

Confirm before `write`, `copy` over an existing destination, `rename`, `truncate`, `rm`, or mounting over a non-empty directory. Then verify with `fs stat`, `fs list`, and `audit show`.

Exec command choice:

- Run a command and wait: `operon exec run <node> -- <command>`.
- Start and return immediately: `operon exec run <node> --detach -- <command>`.
- Open a PTY-backed interactive command when policy allows sessions:
  `operon exec session <node> -- <command>`.
  The CLI uses the attached terminal size by default and forwards Unix resize
  events during interactive sessions.
- Check status: `operon exec status <node> <exec_id>`.
- Read or follow stdout/stderr: `operon exec logs <node> <exec_id>`.
- Send stdin or close it: `operon exec stdin <node> <exec_id>`.
- Cancel: `operon exec cancel <node> <exec_id>`.

Use `exec.run` for non-interactive commands and graph steps. Use
`exec.session` only when the command needs terminal semantics such as shell
line editing, terminal control, or PTY-aware programs. Treat exec execution as
policy-sensitive. Confirm cwd, timeout, secrets, and destructive shell
commands. Check `audit show` after running execs that mutate files, services,
or external systems.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall