denghongcai/Operon / skills/operon-fs-exec
operon-fs-execs
VerifiedUse when an agent needs to read, write, copy, remove, or mount remote files, or run and interact with execs on Operon nodes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
SKILL.md
View on GitHub---
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |