nams:workspace

Select the correct NAMS workspace for a Codex session via structured JSON input.

Updated May 10, 2026
One-click install
npx skills add https://github.com/neo4j-labs/nams-plugins --skill nams-workspace-neo4j-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nams:workspace
Source: https://github.com/neo4j-labs/nams-plugins/tree/main/templates/marketplace/codex/plugins/codex-nams-hooks/skills/workspace
Command: npx skills add https://github.com/neo4j-labs/nams-plugins --skill nams-workspace-neo4j-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves workspace ambiguity by letting Codex explicitly select the correct Neo4j Agent Memory Service workspace for the current session.

Core Features & Use Cases

  • Explicit workspace selection: Handles user requests to switch to a named or identified NAMS workspace.
  • Codex session targeting: Routes the command through the bundled plugin CLI or the installed fallback executable.
  • Controlled command execution: Passes the workspace selector as structured JSON so the plugin can safely interpret the request.
  • Use case: A user sees multiple possible workspaces and needs Codex to continue in the one they intended without manual guesswork.

Quick Start

Ask the assistant to use the NAMS workspace you want by saying nams:workspace use followed by the workspace id or name.

Frequently Asked Questions about nams:workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch the Codex session to a specific Neo4j workspace?

To switch the Codex session to a specific Neo4j workspace, you provide a structured JSON workspace selector to the NAMS plugin, which routes the command through its bundled CLI or fallback executable to update the active memory context.

What is NAMS workspace ambiguity and how does it block my workflow?

NAMS workspace ambiguity occurs when multiple possible memory contexts exist for a Codex session without explicit selection, blocking the workflow until you resolve it by passing the correct workspace identifier to the plugin.

How do I pass a workspace selector to the Neo4j Agent Memory Service?

You pass the workspace selector to the Neo4j Agent Memory Service by issuing a request with the full workspace name or ID, which the Skill translates into structured JSON for safe CLI command execution.

Can I use the NAMS workspace Skill with an installed fallback executable?

Yes, you can use the NAMS workspace Skill with an installed fallback executable, as the command execution logic routes through the bundled plugin CLI first and automatically falls back to the installed executable if needed.

Does the Neo4j workspace selection preserve the full workspace selector text?

Yes, Neo4j workspace selection preserves the full workspace selector text provided in the initial request, ensuring the plugin accurately interprets and applies the exact target memory context without truncation.

When should I manually target a NAMS workspace instead of relying on defaults?

You should manually target a NAMS workspace when you see multiple possible workspaces during a Codex session and need to ensure the agent continues in the specific memory context you intended without guesswork.