Gwirian is a platform for managing BDD scenarios and feature tests. This CLI lets you use the Gwirian API from the terminal with a modern TUI (projects, features, scenarios, and scenario executions).

• Node.js >= 18

Install the CLI globally:

npm install -g @acmada/gwirian-cli

Configure your API token (get it from Gwirian: workspace → API token):

gwirian auth

Optionally test the connection:

gwirian auth --test

Then run the TUI or any command:

gwirian # or gwirian projects list gwirian --help

Cursor and Claude Code can use the gwirian-cli skill so the agent knows how to run the CLI and manage features/scenarios. Install the skill with:

gwirian install --skills

This copies the skill into .cursor/skills/gwirian-cli and .claude/skills/gwirian-cli in the current directory. Options:

• --target cursor — install only for Cursor (.cursor/skills/gwirian-cli)
• --target claude — install only for Claude (.claude/skills/gwirian-cli)
• --target both — install for both (default)
• --global (or -g) — install in your home directory (~/.cursor/skills/gwirian-cli and/or ~/.claude/skills/gwirian-cli)

Examples:

gwirian install --skills --target cursor gwirian install --skills --global

cd gwirian-cli npm install npm run build

Run the binary:

npm start # or node dist/cli.js

During development (no build step):

npm run dev

To run the CLI as gwirian (without prefixing with node or npm start):

Development (global link)
From the project root:

npm run build npm link

After that, the gwirian command is available in your terminal. To remove the link: npm unlink -g @acmada/gwirian-cli.

Global install (permanent binary)
From the project root:

npm run build npm install -g .

The gwirian command is then installed globally (e.g. in the same prefix as your node).

• Token: Generated in Gwirian (workspace member → API token). Enter it once via the TUI or the gwirian auth command.
• Base URL: Default https://app.gwirian.com. Can be changed in the TUI setup or with gwirian config set base-url <url>.

The config file is stored at:

• $XDG_CONFIG_HOME/gwirian-cli/config.json if XDG_CONFIG_HOME is set;
• otherwise ~/.config/gwirian-cli/config.json.

The token is never displayed (including in config get).

In an interactive terminal:

gwirian

• If no token is configured: setup form (token + base URL).
• Otherwise: browse projects → features → scenarios.

Auth and configuration

Install

Projects (list and show only; no create/update/delete)

• gwirian projects list
• gwirian projects show <project-id>

Features

• gwirian features list <project-id>
• gwirian features show <project-id> <feature-id>
• gwirian features create <project-id> [--title] [--description] [--tag-list]
• gwirian features update <project-id> <feature-id> [--title] [--description] [--tag-list]
• gwirian features delete <project-id> <feature-id>

Scenarios

• gwirian scenarios list <project-id> <feature-id>
• gwirian scenarios show <project-id> <feature-id> <scenario-id>
• gwirian scenarios create <project-id> <feature-id> [--title] [--given] [--when] [--then] [--position]
• gwirian scenarios update <project-id> <feature-id> <scenario-id> [...]
• gwirian scenarios delete <project-id> <feature-id> <scenario-id>

Scenario executions

• gwirian scenario-executions list <project-id> <feature-id> <scenario-id>
• gwirian scenario-executions show <project-id> <feature-id> <scenario-id> <execution-id>
• gwirian scenario-executions create <project-id> <feature-id> <scenario-id>
  Options: --status, --notes, --executed-at <iso> (default: now), --tag-list <list> (comma-separated, e.g. e2e,v1.2.3)
• gwirian scenario-executions update <project-id> <feature-id> <scenario-id> <execution-id>
  Options: --status, --notes, --executed-at <iso>, --tag-list <list>
• gwirian scenario-executions delete <project-id> <feature-id> <scenario-id> <execution-id>

Global options

• --base-url <url>: Override base URL for the command.
• --json: Raw JSON output (instead of formatted tables for list/show).

Examples:

gwirian --help gwirian --json projects list gwirian --base-url https://staging.gwirian.com projects list

MIT.