# Operator

`operator` is a coding-first terminal AI agent from the `ProjectZero` ecosystem.

It starts with software development, repository work, shell execution, and technical workflows, but it is not meant to stop there. The longer direction is a stronger operator layer for your machine: local projects, execution flows, infrastructure-style tasks, model routing, and broader on-device control.

This is the path toward a more capable `operator` surface, not just another chat wrapper.

## What it is

- coding-first terminal intelligence
- real CLI, installed through npm
- built for repository work, patching, shell execution, and session continuity
- supports hosted and local model rails
- keeps user state in a hidden local directory instead of polluting the package itself

## Product direction

`operator` begins as a serious coding agent.

That means:

- reading code
- editing files
- running commands
- resuming technical sessions
- working across local repositories

But the broader direction is larger than coding alone:

- terminal execution
- technical operations
- localhost project control
- dev workflows
- model-flexible runtime selection

The long-term goal is a stronger device-level operator surface inside the `ProjectZero` ecosystem.

## Install

One command for Linux, macOS, and Windows:

```bash
npm install -g pzero-operator
```

After install:

```bash
operator
```

## Platform status

- Linux: supported
- macOS: supported
- Windows: supported

Requirements:

- Node.js 20+
- npm
- a terminal environment such as Terminal, iTerm, Windows Terminal, PowerShell, or a standard shell session

## Model rails

`operator` currently works with two main runtime paths:

### Alem AI Plus

Hosted path for fast startup.

- site: `https://plus.alem.ai/`
- services: `https://plus.alem.ai/services`
- current hosted profiles in `operator`:
  - `gpt-oss`
  - `qwen3.6 27b`
  - `gemma4`

The first time a hosted model is selected, `operator` asks for the relevant API key and stores local state in the hidden agent directory.

### Ollama

Optional local or cloud model path.

You can switch into Ollama with:

```bash
operator use ollama
```

This path is useful when you want a more local-first runtime or want to move between local and cloud Ollama models.

## First-run flow

Typical first use:

1. install the package from npm
2. run `operator`
3. if using `Alem AI Plus`, choose a model and enter the API key when asked
4. if using `Ollama`, switch with `operator use ollama`
5. start working inside the terminal

## What `operator` can do now

- inspect repositories
- patch and write files
- execute shell commands
- continue prior sessions
- route between hosted and local model paths
- work as a coding-first assistant for technical workflows

## Data layout

Package runtime:

- installed by npm

User state:

- stored in the hidden directory `~/.operator/agent`

This includes:

- sessions
- model settings
- local auth state

That separation keeps the package cleaner and makes user state easier to manage independently.

## ProjectZero

`operator` is part of `ProjectZero`, a Kazakhstan startup building a broader ecosystem around AI products, AI agents, execution layers, and technical operator surfaces.

`operator` is the public terminal command layer inside that ecosystem.

## Release posture

This package is intended to be installed as a real product surface, not just read as source.

Release packages do not ship:

- local sessions
- local auth files
- user machine state

## License

MIT
