dalhe-cli

dalhe-cli

CLI for bootstrapping projects with Dalhe base files.

What it does

dalhe init copies the template from src/template/init into the current directory, prepares the initial project structure, and runs openspec init --tools claude,codex.

dalhe skill lists, installs, removes, and updates skills maintained in src/template/skills, publishing them globally for Codex and Claude Code. Official skills do not use prefixes.

dalhe update updates the global CLI installation and also updates OpenSpec.

Current template includes:

• AGENTS.md
• CLAUDE.md
• .ai-framework/DESIGN.md
• .ai-framework/RULES.md

During init, if any destination file already exists, execution stops and nothing is overwritten.

Requirements

• Node.js >=22.0.0

Installation

Package on npm: https://www.npmjs.com/package/dalhe-cli

Via npm

Install directly from npm:

npm install -g dalhe-cli

OpenSpec is installed automatically on the first dalhe init if it is not already available in PATH.

Via internal Git repository

Install directly from repository:

npm install -g git+https://github.com/alexishida/dalhe-cli.git

OpenSpec is installed automatically on the first dalhe init if it is not already available in PATH.

Via local source code

Inside project repository:

npm install -g .

OpenSpec is installed automatically on the first dalhe init if it is not already available in PATH.

Quick start

Go into folder where you want to create project base:

dalhe init

Example:

mkdir my-project
cd ./my-project
dalhe init

Commands

dalhe init
dalhe skill list
dalhe skill install <skill-name>
dalhe skill uninstall <skill-name>
dalhe skill update-all
dalhe update
dalhe --help
dalhe -h
dalhe --version
dalhe -v

init behavior

• Copies all template files into current folder.
• Creates required directories automatically.
• Blocks overwrites when a conflict is found.
• If openspec is not available in PATH, runs npm install -g @fission-ai/openspec@latest.
• After copying, runs openspec init --tools claude,codex in current folder.
• This mode avoids the interactive OpenSpec menu and installs configuration directly for Claude Code and Codex.
• Requires npm to be installed in order to install OpenSpec automatically when needed.
• Shows total number of copied files at the end.

Project structure

• bin/dalhe.js: CLI entry point.
• src/commands: application commands.
• src/core: execution base and error handling.
• src/services: support services.
• src/template/init: base files copied by init.
• src/template/skills: skill helper files maintained in repository.
• test: automated tests.
• .ai-framework/RULES.md: official project rules, including technical context and mandatory change guidelines.

skill command

Listing

Lists all skills available in src/template/skills.

Currently included skills:

• rails8: support for development, refactoring, and review of Rails 8 apps.
• code-review: review of quality, architecture, and patterns in Rails code.
• security-audit: Rails security audit focused on OWASP, Brakeman, and common vulnerabilities.

dalhe skill list

Installation

Installs a skill globally in both environments:

• Codex: copies entire skill folder to $CODEX_HOME/skills/<skill-name>.
• Codex without CODEX_HOME: uses ~/.codex/skills/<skill-name> on Linux and %USERPROFILE%\.codex\skills\<skill-name> on Windows.
• Claude Code: copies entire skill folder to ~/.claude/skills/<skill-name> on Linux and %USERPROFILE%\.claude\skills\<skill-name> on Windows.
• If skill already exists in global destination, that skill folder is replaced with current template version.

dalhe skill install rails8

Uninstallation

Removes skill from both global destinations.

dalhe skill uninstall rails8

Bulk update

Reinstalls all skills from this CLI that are already installed in at least one managed destination, syncing current template version to Codex and Claude Code.

dalhe skill update-all

update command

Updates CLI globally from official repository and syncs OpenSpec:

dalhe update

Behavior:

• Runs npm install -g git+https://github.com/alexishida/dalhe-cli.git.
• Then runs npm install -g @fission-ai/openspec@latest.
• Uses npm.cmd on Windows.
• Uses npm on Linux.
• Requires npm to be installed and permission to update global packages.

Local development

Any project change must keep this README.md updated whenever there is impact on behavior, usage, commands, flow, structure, requirements, or any relevant tool context.

npm install
npm test
node ./bin/dalhe.js --help

To test full flow without installing globally:

node ./bin/dalhe.js init

In this case, make sure npm is installed and available in PATH, so CLI can install OpenSpec automatically when needed.

License

MIT

Publish package to npm

If you need to renew npm authentication before publishing:

npm logout
npm login
npm whoami
npm publish