Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# MetaMask Agent CLI Skills

SKILLs for the MetaMask Agent CLI (`@metamask/agentic-cli` v3.0.0). These skills enable AI agents to authenticate, manage wallets, swap tokens, bridge across chains, trade perpetual futures, and more using the MetaMask Agent CLI.
SKILLs for the MetaMask Agent CLI (`@metamask/agentic-cli` v3.2.0). These skills enable AI agents to authenticate, manage wallets, swap tokens, bridge across chains, trade perpetual futures, and more using the MetaMask Agent CLI.

## Skills

Expand Down
8 changes: 4 additions & 4 deletions skills/metamask-agent-wallet/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ description: Use when the user asks anything about blockchain wallets, transacti
license: MIT
metadata:
author: metamask
version: "4.1.0"
cliVersion: "3.0.0"
version: "4.2.0"
cliVersion: "3.2.0"
---

# MetaMask Agentic CLI Skill
Expand Down Expand Up @@ -155,7 +155,7 @@ Run these checks before the first CLI operation in a session, in order.

### 1. Version compatibility

This skill is written for `@metamask/agentic-cli` **v3.0.0** (see `cliVersion` in the frontmatter). Check the installed version:
This skill is written for `@metamask/agentic-cli` **v3.2.0** (see `cliVersion` in the frontmatter). Check the installed version:

```bash
mm --version
Expand All @@ -169,7 +169,7 @@ npm view @metamask/agentic-cli version

If the installed `major.minor` differs from the pinned `cliVersion`, or the installed version is behind the latest release, warn the user once and continue:

> Version mismatch: installed CLI `<installed>`, this skill is pinned to `3.0.0`, latest release is `<latest>`. Command syntax in this skill may be inaccurate until they are aligned. Update the CLI with `npm install -g @metamask/agentic-cli@latest`, then re-install the skills with `npx skills add metaMask/agent-skills`.
> Version mismatch: installed CLI `<installed>`, this skill is pinned to `3.2.0`, latest release is `<latest>`. Command syntax in this skill may be inaccurate until they are aligned. Update the CLI with `npm install -g @metamask/agentic-cli@latest`, then re-install the skills with `npx skills add metaMask/agent-skills`.

Run this check once per session. Do not block operations on it.

Expand Down
20 changes: 13 additions & 7 deletions skills/metamask-agent-wallet/references/auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ mm login --token "cliToken:cliRefreshToken"
### Note

- If already authenticated, the CLI returns `ALREADY_AUTHENTICATED`. Run `mm logout` first, then log in again.
- `mm login qr` (scan with MetaMask Mobile) is available on non-production builds (dev/uat). On production it returns `COMING_SOON`; use browser sign-in instead.
- `mm login qr` (scan with MetaMask Mobile) is available on all environments, including production.
- Pairing codes tolerate `-` and whitespace separators (e.g. `608-225` is equivalent to `608225`).
- Use `mm login browser --no-wait` for non-interactive/CI flows. The command prints a sign-in URL; the user completes login in the browser (Google or Email). Bare `mm login --no-wait` fails without a TTY because no method is selected.
- `--no-wait` is not supported with QR login. Complete authentication later with `mm login --token`.
Expand Down Expand Up @@ -115,22 +115,25 @@ mm auth status --toon

## `logout` Command

Sign out and clear auth credentials plus local init state, wallet selection, and stored BYOK mnemonic.
Sign out and clear auth credentials plus local init state, wallet selection, and stored BYOK mnemonic. Prompts for confirmation before signing out.

### Syntax

```bash
mm logout
mm logout [--yes]
```

### Supported Flags

This command does not support flags.
| Name | Required | Description |
| --- | --- | --- |
| `--yes` | No | Skip the confirmation prompt (for non-interactive/scripted use) |

### Example

```bash
mm logout
mm logout --yes
```

## `config get` Command
Expand Down Expand Up @@ -204,22 +207,25 @@ mm config set format toon

## `reset` Command

Clear the local CLI session entirely, including auth credentials, wallet state, mnemonic, swap quotes, and persisted config.
Clear the local CLI session entirely, including auth credentials, wallet state, mnemonic, swap quotes, and persisted config. Prompts for confirmation before resetting.

### Syntax

```bash
mm reset
mm reset [--yes]
```

### Supported Flags

This command does not support flags.
| Name | Required | Description |
| --- | --- | --- |
| `--yes` | No | Skip the confirmation prompt (for non-interactive/scripted use) |

### Example

```bash
mm reset
mm reset --yes
```

## `wallet password set` Command
Expand Down
2 changes: 1 addition & 1 deletion skills/metamask-agent-wallet/workflows/login.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ mm login browser --no-wait

The command prints a sign-in URL. The user opens it in a browser and chooses Google or Email to complete sign-in.

`mm login qr` (scan with MetaMask Mobile) is available on non-production builds (dev/uat); on production it returns `COMING_SOON`. QR login keeps the CLI attached to the relay, so it does not support `--no-wait`.
`mm login qr` (scan with MetaMask Mobile) is available on all environments, including production. QR login keeps the CLI attached to the relay, so it does not support `--no-wait`.

## Verify

Expand Down
2 changes: 1 addition & 1 deletion skills/metamask-agent-wallet/workflows/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,4 @@ For raw error-code meanings, load `../references/errors.md`. Relay CLI errors ve

## Reset Last

Use `mm reset` only after checking version, auth status, and the failing command's help output. Reset clears local session state and should not be the first troubleshooting step. Always ask the user for explicit confirmation before running reset.
Use `mm reset` only after checking version, auth status, and the failing command's help output. Reset clears local session state and should not be the first troubleshooting step. Always ask the user for explicit confirmation before running reset. The command itself also prompts for confirmation; pass `--yes` to skip the prompt in non-interactive sessions.
8 changes: 4 additions & 4 deletions skills/metamask-agent-workflows/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ description: Use when the user needs to perform multi-step operations with the M
license: MIT
metadata:
author: metamask
version: "4.0.0"
cliVersion: "3.0.0"
version: "4.1.0"
cliVersion: "3.2.0"
---

# MetaMask Agent Workflows
Expand Down Expand Up @@ -47,7 +47,7 @@ Run these checks before the first CLI operation in a session, in order.

### 1. Version compatibility

This skill is written for `@metamask/agentic-cli` **v3.0.0** (see `cliVersion` in the frontmatter). Check the installed version:
This skill is written for `@metamask/agentic-cli` **v3.2.0** (see `cliVersion` in the frontmatter). Check the installed version:

```bash
mm --version
Expand All @@ -61,7 +61,7 @@ npm view @metamask/agentic-cli version

If the installed `major.minor` differs from the pinned `cliVersion`, or the installed version is behind the latest release, warn the user once and continue:

> Version mismatch: installed CLI `<installed>`, this skill is pinned to `3.0.0`, latest release is `<latest>`. Command syntax in this skill may be inaccurate until they are aligned. Update the CLI with `npm install -g @metamask/agentic-cli@latest`, then re-install the skills with `npx skills add metaMask/agent-skills`.
> Version mismatch: installed CLI `<installed>`, this skill is pinned to `3.2.0`, latest release is `<latest>`. Command syntax in this skill may be inaccurate until they are aligned. Update the CLI with `npm install -g @metamask/agentic-cli@latest`, then re-install the skills with `npx skills add metaMask/agent-skills`.

Run this check once per session. Do not block operations on it.

Expand Down
2 changes: 1 addition & 1 deletion skills/metamask-agent-workflows/workflows/login.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ mm login browser --no-wait

The command prints a sign-in URL. The user opens it in a browser and chooses Google or Email to complete sign-in.

`mm login qr` (scan with MetaMask Mobile) is available on non-production builds (dev/uat); on production it returns `COMING_SOON`. QR login keeps the CLI attached to the relay, so it does not support `--no-wait`.
`mm login qr` (scan with MetaMask Mobile) is available on all environments, including production. QR login keeps the CLI attached to the relay, so it does not support `--no-wait`.

## Verify

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,4 @@ For raw error-code meanings, load `../references/errors.md`. Relay CLI errors ve

## Reset Last

Use `mm reset` only after checking version, auth status, and the failing command's help output. Reset clears local session state and should not be the first troubleshooting step. Always ask the user for explicit confirmation before running reset.
Use `mm reset` only after checking version, auth status, and the failing command's help output. Reset clears local session state and should not be the first troubleshooting step. Always ask the user for explicit confirmation before running reset. The command itself also prompts for confirmation; pass `--yes` to skip the prompt in non-interactive sessions.