# Nams:workspace

> Explicitly use $nams:workspace use <workspace-id-or-name> to select the NAMS workspace for the current Codex session after a NAMS workspace ambiguity notice.

- Skill: `neo4j-labs/nams-workspace-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add neo4j-labs/nams-workspace-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/neo4j-labs/nams-workspace-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: neo4j-labs (https://skillmd.com/u/neo4j-labs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/neo4j-labs/nams-workspace-2

---


# NAMS Workspace Selection

Use this skill only when the user explicitly invokes `$nams:workspace use <workspace-id-or-name>`.

Extract the selector as the full text after `use`. Preserve spaces inside the selector.

Run the NAMS workspace command through the bundled plugin CLI:

```bash
node bin/cli.js workspaces run codex --event CustomCommand
```

If the bundled CLI is unavailable, use the installed executable fallback:

```bash
nams-hooks workspaces run codex --event CustomCommand
```

Pass this JSON object on stdin:

```json
{
  "command_name": "nams:workspace",
  "command_args": "use <workspace-id-or-name>"
}
```

Report the command output to the user. If the command asks for the explicit shell fallback with `<session-id>`, show that fallback exactly.