Operator-Use Skill

How to use Operator-Use Skill

uv pip install ".[memory]"

## Process manager

The `process` tool manages two kinds of background processes:

**Shell processes** — run arbitrary commands with captured output:

```python
# start
{ "action": "start", "command": "npm run dev", "description": "dev server" }
# read output (last N bytes from in-memory ring buffer)
{ "action": "output", "process_id": "<id>", "max_bytes": 8000 }
# stop
{ "action": "stop", "process_id": "<id>" }
```

**Agent processes** — spawn a background `operator acp serve` session with multi-turn interaction:

```python
# spawn
{ "action": "spawn_agent", "prompt": "watch the logs and alert on errors",
  "description": "log watcher", "provider": "anthropic", "model": "claude-sonnet-4-6" }
# send follow-up prompts
{ "action": "write", "process_id": "<id>", "prompt": "now check /var/log/app.log" }
# read disk log
{ "action": "output", "process_id": "<id>" }
```

Shell output is stored in an in-memory ring buffer (1 MB cap per process). Agent output is written to a disk log file under the active profile's `temp/` directory.

## Workflows

Workflows are Python files that orchestrate multi-step tasks using a built-in async DSL:

```python
# ~/.operator/profiles/<name>/workflows/rese

What is Operator-Use Skill?

Operator-Use is a Python AI agent skill for Cursor, Codex with npx, uvx/pip. 🐧Operator-Use: AI that can do stuffs on your computer This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.

Key capabilities

• Reusable instructions support
• Includes SKILL.md support
• Shell commands support
• Browser use support
• Document generation support
• OpenAI provider support
• Anthropic provider support

Available tools

Technical details

Install or run Operator-Use using npx. Check CursorTouch/Operator-Use for the latest setup command.

• Built for Python
• Built for Node.js
• Built for Go
• Install or run with npx
• Install or run with uvx/pip
• Works with Cursor
• Works with Codex
• Uses stdio transport

Requirements and access

Security and permissions

Review permissions before connecting any MCP server to an agent. Pay special attention to whether it can read local files, write data, call external services, or perform destructive actions.

When to use Operator-Use Skill

• Use it for reusing agent instructions, scripts, and references.
• Use it for agent skills workflows.
• Use it for coding workflows.
• Use it for data workflows.
• Use it for cursor users.

Built with

Explore related resources

Frequently asked questions