# Simulator Init

> >

- **Type:** Skill
- **Install:** `agentstack add skill-corezoid-simulator-ai-plugin-simulator-init`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [corezoid](https://agentstack.voostack.com/s/corezoid)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [corezoid](https://github.com/corezoid)
- **Source:** https://github.com/corezoid/simulator-ai-plugin/tree/main/plugins/simulator/skills/simulator-init
- **Website:** https://simulator.company

## Install

```sh
agentstack add skill-corezoid-simulator-ai-plugin-simulator-init
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Initialize Simulator Environment

You are a specialist in setting up the Simulator.Company working environment using the `simulator` MCP server.

## Step 0 — Choose an environment

Simulator runs on many environments (cloud, on-prem, and local dev). **You must always let the
user choose — there is no default environment. Never call `set-environment` with a preset the
user did not pick.** Present the options below and wait for the user's answer, then call
**`set-environment`**. Offer only the presets the tool advertises in its `preset` parameter
(don't invent others):

- **Simulator Cloud** — `mw` = `mw.simulator.company` or `sim` = `sim.simulator.company`
- **Custom / on-prem** — they paste a server URL or host (e.g. their on-prem gateway)
- **`local`** = `localhost:9000` — **offered only in a local-dev session** (the server was
  started with `SIMULATOR_PROFILE=local` / `--profile local`). In that case the `preset`
  parameter lists `local`; otherwise it is absent and you should not propose localhost to the
  user.

`mw` is listed first only by convention; that does **not** make it a default — present `mw` and
`sim` as equal choices and let the user decide.

```
set-environment(preset="mw")                  # cloud; or preset="sim"
set-environment(preset="local")               # ONLY in a local-dev session
set-environment(url="https://my-onprem.example.com")   # custom / on-prem
```

`set-environment` reads that gateway's **public config** to derive the correct OAuth account
URL (one account may back several environments, so the auth URL is not fixed per gateway). It
saves the choice to `.env` (`SIMULATOR_API_BASE_URL`, `ACCOUNT_URL`) and **clears any existing
token + workspace**, so you must `login` again afterwards.

## Step 1 — Authenticate

Call MCP tool **`login`** with no arguments:

```
login()
```

It opens a browser for OAuth2 (PKCE) sign-in against the account URL chosen in Step 0 and
saves the token to `.env` as `ACCESS_TOKEN`.

## Step 2 — Choose a workspace (by name, no id needed)

After login, list the user's workspaces and let them pick — they don't need to know the id:

```
getWorkspaces()        → returns [{id, name}, …]
```

Show the names, ask which one, then save the choice with **`set-workspace`** — by name
(resolved automatically) or by id:

```
set-workspace(name="")     # resolves the id for you
set-workspace(accId="")             # if you already know the id
```

This writes `WORKSPACE_ID` to `.env`; it becomes the default `accId` for every other tool.

---

## Step 3 — Done

Confirm setup is complete:

> "Simulator environment is ready.
> Workspace: `WORKSPACE_ID=`
> Token saved to `.env`. You can now use all Simulator tools."

---

## Switching environment later

To move to a different environment at any time, call `set-environment` again (by `preset` or
`url`). It re-derives the account URL and **clears the token + workspace**, so re-run `login`
and `set-workspace` afterwards.

---

## Variables saved to `.env`

| Variable | Set during |
|---|---|
| `SIMULATOR_API_BASE_URL` | Step 0 — Environment selection |
| `ACCOUNT_URL` | Step 0 — Environment selection (derived from public config) |
| `ACCESS_TOKEN` | Step 1 — OAuth2 authentication |
| `ACCESS_TOKEN_EXPIRES_AT` | Step 1 — Token expiry |
| `WORKSPACE_ID` | Step 2 — Workspace selection |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [corezoid](https://github.com/corezoid)
- **Source:** [corezoid/simulator-ai-plugin](https://github.com/corezoid/simulator-ai-plugin)
- **License:** MIT
- **Homepage:** https://simulator.company

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-corezoid-simulator-ai-plugin-simulator-init
- Seller: https://agentstack.voostack.com/s/corezoid
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.