@enscribe/enscribe-cli

Standalone TypeScript CLI for Enscribe subname operations. The installed command-line name is enscribe-cli.

Installation

After publishing this package to npm, install it globally with:

npm install -g @enscribe/enscribe-cli

Then verify the CLI is available:

enscribe-cli --help

Local Development

npm install
npm run build
node dist/cli.js --help

You can also run the TypeScript entrypoint directly during development:

npx tsx src/cli.ts --help

Publishing To npm

Before publishing:

1. Confirm you can publish to the @enscribe scope on npm.
2. Remove "private": true from package.json if present.
3. Bump the version in package.json.
4. Build and verify the package contents locally.
5. Log in with npm login.
6. Publish with npm publish (scoped packages often use npm publish --access public on first publish).

Configuration

Environment variables:

• ENSCRIBE_API_BASE_URL
• ENSCRIBE_API_KEY
• ENSCRIBE_ORG_ID

Commands

enscribe-cli --help
enscribe-cli list --help
enscribe-cli create --help
enscribe-cli metadata --help

Examples

enscribe-cli list --org-id org_123 --chain-id 8453
enscribe-cli create --org-id org_123 --parent myorg.eth --label app --chain-id 8453
enscribe-cli metadata list --org-id org_123 --name app.myorg.eth --chain-id 8453
enscribe-cli metadata add --org-id org_123 --name app.myorg.eth --chain-id 8453 --text url=https://app.example.com
enscribe-cli metadata add --org-id org_123 --name app.myorg.eth --chain-id 8453 --addr 60=0x1234567890abcdef1234567890abcdef12345678
enscribe-cli metadata rm --org-id org_123 --name app.myorg.eth --chain-id 8453 --text url
enscribe-cli metadata del --org-id org_123 --name app.myorg.eth --chain-id 8453 --addr 60

AI Agent Integration

Use your agent's skill installation steps to add the enscribe-cli skill to it. Here's how to install & use this skill for the Cursor IDE:

Install The Skill In Cursor

1. Install the published CLI so Cursor agents can invoke enscribe-cli:

npm install -g @enscribe/enscribe-cli

2. Create a project-local Cursor skills directory:

mkdir -p .cursor/skills/enscribe-cli

3. Copy this repository's skill definition into Cursor's expected location:

cp SKILL.md .cursor/skills/enscribe-cli/SKILL.md

4. Make sure the required environment variables are created in an .env file:

export ENSCRIBE_API_BASE_URL=...
export ENSCRIBE_API_KEY=...
export ENSCRIBE_ORG_ID=...

5. Open Cursor IDE in this workspace and ask the agent to use the @enscribe/enscribe-cli skill for Enscribe subname tasks.

Example Prompts

• Use the @enscribe/enscribe-cli skill to list all subnames for my org on Sepolia (chain ID 11155111).
• Use the @enscribe/enscribe-cli skill to create a subname xyz under my org on Sepolia (chain ID 11155111).