aleph-cli

Manage Aleph campaigns and related data via command-line JSON output.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/LudoBermejoES/aleph --skill aleph-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aleph-cli
Source: https://github.com/LudoBermejoES/aleph/tree/main/.claude/skills/aleph-cli
Command: npx skills add https://github.com/LudoBermejoES/aleph --skill aleph-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Aleph CLI consolidates campaign and data management tasks into a single, scriptable interface, reducing manual workflow overhead and ensuring consistent operations across campaigns.

Core Features & Use Cases

  • Campaign lifecycle: list, show, create, update, delete, export, and import campaigns.
  • Entity, character, location, organization, session, and map management via a uniform CLI.
  • JSON output with --json for machine parsing and automation; interactive prompts with safe defaults.
  • Authentication and configuration management via the config and login commands to securely store API keys.

Quick Start

Install dependencies, configure the CLI, and run a basic command such as aleph campaign list --json to verify setup.

Frequently Asked Questions about aleph-cli

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

FAQPage Schema
How do I automate Aleph campaign management from the command line?

You can automate Aleph campaign management by executing CLI commands to list, create, update, and delete campaign data. The tool provides scriptable commands and JSON output for seamless integration into automated workflows.

What is the best way to get JSON output for Aleph campaign data in automation scripts?

The best way to get JSON output for Aleph campaign data is to append the --json flag to your CLI commands. This formats the command response for machine parsing, making it ideal for automation scripts and programmatic data extraction.

How do I configure authentication for the Aleph CLI?

You configure authentication for the Aleph CLI by using the config and login commands to securely store your API keys. This setup ensures that your command line interactions are authenticated before managing campaign entities.

Can I manage characters, locations, and organizations within Aleph campaigns using this CLI?

Yes, you can manage characters, locations, and organizations using this CLI. The tool provides a uniform command interface to handle these entities alongside sessions and maps, ensuring comprehensive campaign data management.

Do I need Node.js to run Aleph CLI commands for campaign lifecycle operations?

Yes, you need Node.js to run Aleph CLI commands because the tool relies on node-based execution. This environment is required to perform campaign lifecycle operations such as exporting, importing, and updating campaign data.

Why does my Aleph CLI command fail when I try to import a campaign?

Your Aleph CLI command might fail during a campaign import due to incorrect API key configuration or missing safe defaults in the interactive prompts. The tool includes error handling to help identify these authentication or input issues.