EN
EN

LOCAL AGENT ONBOARDING

Give Actionway CLI
to your agent

Copy the first message below into Codex, Claude, or another local agent. It will install the CLI, open browser authorization, and give you a concise Quick Start when connected.

Choose your agent Browse capabilities

WORKS WITH YOUR LOCAL AGENT

Start with the agent you already use.

Codex and Claude can install the Actionway Skill. Any other local agent that can run commands and open a browser can use the CLI too.

CHOOSE YOUR LOCAL AGENTManual selection
Codex

Let Codex install the CLI and its Actionway Skill.

SKILL DESTINATION~/.codex/skills/actionway
COPY THE MESSAGE TO CodexREADY / COPY
Set up Actionway for Codex.

1. Confirm the host OS is macOS or Linux. If it differs, stop and ask me to copy the matching setup message from the website.
2. If your shell is sandboxed with network restrictions (e.g. the Claude Code sandbox), first allow `registry.npmjs.org`, `actionway.ai`, and `*.actionway.ai` — for Claude Code add them to `sandbox.network.allowedDomains` in settings. Blocked egress surfaces as a bare 403. Ask me before editing settings files.
3. Install by running `curl -fsSL https://actionway.ai/install.sh | sh`. The installer checks Node.js 20+ (installing the LTS if missing), installs the Actionway CLI, and runs its doctor check. Do not use `sudo` without my approval. If doctor reports failed checks, report them and stop; do not change npm registry, proxy, CA, PATH, or shell profile without my approval.
4. Run `actionway --agent-host=codex init --install-session-id=<install-session-id>`. For this Agent, keep the same `--agent-host` declaration immediately after `actionway` on every future Actionway command. Let me approve browser access; never ask me to paste credentials.
5. Read the `skill` block in the init output and use its local `source` path. Install it at `~/.codex/skills/actionway` so Codex can load it in future sessions.
6. Replace an existing destination only if it is an earlier Actionway Skill; otherwise ask me first.
7. Verify setup with `actionway --agent-host=codex whoami`, then give me three short examples from `actionway --agent-host=codex --help`.
  1. 01

    Install the Actionway CLI

  2. 02

    Sign in safely in the browser

  3. 03

    Install the Skill in Codex's Skill directory

WHAT HAPPENS NEXT

You only approve access in the browser.

  1. 01

    The agent checks Node and npm

  2. 02

    It installs Actionway CLI

  3. 03

    You sign in safely in the browser

  4. 04

    It installs the Skill and returns examples

YOUR FIRST TASK

Once connected, describe the goal directly.

The agent discovers capabilities and reads inputs and pricing itself. It asks again before paid execution.

EXAMPLE 01

“Turn this image into a 10-second video and keep the character consistent.”

EXAMPLE 02

“Turn this paragraph into natural English narration.”

EXAMPLE 03

“Transcribe this video and tell me where the shot changes happen.”

MANUAL & TROUBLESHOOTING

Install manually only when needed

Let the agent handle these steps by default. Use them yourself only when the agent cannot change the local environment or you are troubleshooting.

01

1. Install the CLI

Install the Actionway CLI globally. The executable is actionway.

Windows: powershell -ExecutionPolicy Bypass -Command "irm https://actionway.ai/install.ps1 | iex"
macOS/Linux: curl -fsSL https://actionway.ai/install.sh | sh
02

2. Initialize Actionway

Init opens browser authorization and stages the thin Skill at the fixed local path ~/.actionway/skill. Never paste a token or credential into the agent chat.

Windows: actionway.cmd doctor
         actionway.cmd init
macOS/Linux: actionway doctor
             actionway init
03

3. Verify the setup

Confirm that identity and command discovery work. Then ask the agent for Actionway tasks in natural language.

Windows: actionway.cmd whoami
         actionway.cmd --help
macOS/Linux: actionway whoami
             actionway --help