Package Exports

@impulselab/directory
@impulselab/directory/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@impulselab/directory) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Impulse Directory Command Installer

An NPX command by Impulse Lab that downloads prompts from Impulse Directory and installs them for Claude Desktop or Cursor.

🚀 Installation and Usage

Direct usage with npx

npx @impulselab/directory <user-slug>/<command-slug> [--target <target>]
npx @impulselab/directory stack <stack-id> [--target <target>]

--target selects the installation target. When omitted the command defaults to claude-slash.

When using the stack command, all prompts in the stack are installed for the chosen tool. Stacks must be constrained to a specific tool to be installed via NPX.

Targets

Target	Description	Destination
`claude-slash`	Claude slash command	`.claude/commands` (falls back to `~/.claude/commands`)
`claude-sub-agent`	Claude sub agent	`.claude/agents` (falls back to `~/.claude/agents`)
`cursor-command`	Cursor command	`.cursor/commands` (project only)
`cursor-rule`	Cursor rule	`.cursor/rules` (project only)

Note: Cursor targets require running the installer inside a Cursor project (a folder containing .cursor/). The command fails if no project folder is found.

Examples

# Download a Claude slash command from impulse.directory
npx @impulselab/directory john/my-awesome-command

# Install as a Claude sub agent
npx @impulselab/directory john/my-awesome-command --target claude-sub-agent

# Install as a Cursor command (inside a Cursor project)
npx @impulselab/directory john/my-awesome-command --target cursor-command

# Install as a Cursor rule (inside a Cursor project)
npx @impulselab/directory john/my-awesome-command --target cursor-rule

# Install an Impulse stack (tool-specific stack ID)
npx @impulselab/directory stack 01JH0000000ABCDEF --target claude-slash

# Use a custom URL (local development)
IMPULSE_BASE_URL=localhost:3000 npx @impulselab/directory dev-user/dev-command

# Use another server
IMPULSE_BASE_URL=my-custom-domain.com npx @impulselab/directory author/custom-command

📁 Command Placement Logic

Claude targets (`claude-slash`, `claude-sub-agent`)

The command searches for the .claude folder in the following order:

Current folder: Looks for .claude/<target>/ in the current working directory
Parent folders: Goes up the tree to find a .claude folder
Fallback home: Uses ~/.claude/<target>/ if no project folder is found

This allows:

Installing commands at the project level (shared with the team)
Installing personal commands (user only)

Cursor targets (`cursor-command`, `cursor-rule`)

Must be executed inside a Cursor project (a directory containing .cursor/)
Always installs into the project .cursor folder
Fails with an explicit message if no Cursor project is detected

🔧 Configuration

Environment Variables

Variable	Description	Default
`IMPULSE_BASE_URL`	Base URL to download commands	`impulse.directory`

Automatic HTTPS/HTTP Handling

HTTPS by default: All URLs use HTTPS
Fallback HTTP: If HTTPS fails, the command automatically tries HTTP
Localhost auto-HTTP: URLs containing localhost or 127.0.0.1 use HTTP directly

📝 Command Format

Downloaded prompts are saved as <command-slug>.md. Stack installs will save each command in the stack using the prompt slug (with a stack-prefixed fallback when needed).

Example download URL:

https://impulse.directory/raw/user-slug/command-slug

Stack installation payloads are fetched from:

https://impulse.directory/api/stacks/<stack-id>/npx

🛠️ Development

Local Test

# From the npx/impulse-claude/ folder
node index.js --help
node index.js test-user/test-command

File Structure

npx/impulse-claude/
├── package.json    # NPM configuration
├── index.js        # Main script
└── README.md       # Documentation

📚 Using Downloaded Prompts

Claude slash commands: use /command-name inside Claude Desktop.
Claude sub agents: open Claude Desktop and select the agent from the agents list.
Cursor commands: trigger Cursor's command palette and run the command by name.
Cursor rules: Cursor loads rules automatically from .cursor/rules for the project.

🔍 Troubleshooting

Common Errors

Command not found (404): Check the command slug
Network error: Check your connection and the base URL
Permissions: Make sure you have write permissions in the destination folder
Cursor project missing: Ensure you're running the command inside a folder containing .cursor/

Debug

To see download details:

# The command automatically displays the download path and destination folder
npx @impulselab/directory debug-user/debug-command

🏷️ Branding

Made by Impulse Lab — https://impulselab.ai

@impulselab/directory