# os Shell and Process Tools Manual

## Template (Index)

### One-line Positioning

- <What this toolset is for, in one sentence>

### Tool List

- <Enumerate core tools or point to the Tools section>

### 30-Second Quickstart

1. <call ...>
2. <observe ...>
3. <next step ...>

### Navigation

- principles / tools / scenarios / errors

### Boundaries vs Other Toolsets

- <When to use this vs a sibling toolset>

os is Dominds' **shell and process toolset** for executing system commands and managing processes:

- **Shell execution**: Execute system commands
- **Process management**: Start, stop, view daemon processes
- **Environment variables**: Read, set, delete environment variables

## Quick Navigation

| Topic                         | Description                                        |
| ----------------------------- | -------------------------------------------------- |
| [principles](./principles.md) | Core concepts, security principles, best practices |
| [tools](./tools.md)           | Usage guidance, boundaries, and operational notes  |
| [scenarios](./scenarios.md)   | Common usage scenarios (copy-paste ready)          |
| [errors](./errors.md)         | Error codes and solutions                          |

## Status

- Status: Implemented
- Main implementation files:
  - Tool implementation: `dominds/main/tools/os.ts`
  - Toolset metadata: `dominds/main/tools/builtins.ts`, `dominds/main/tools/registry.ts`

## Security Notes

⚠️ Shell command execution requires caution:

- Avoid destructive commands (e.g., `rm -rf`)
- Use explicit paths to avoid path injection; on Windows, prefer forward-slash paths
- Verify command output before executing follow-up operations
