seyola-runtime

Local CLI runtime for the Seyola business operating system. Reads contracts and registries from a Seyola pack and executes them against a runtime backend (Claude Code local subprocess).

This is the engine. The product (Seyola pack + workspace) is at https://github.com/seyola-community/seyola-paid for members.

Install

npm install -g @adhamalkhaja/seyola-runtime

Requires Node 20 or higher.

Verify:

seyola-runtime --version

Usage

The runtime is invoked via subcommands. The most common flow for a Seyola member:

# Get a workspace (clone the client bundle).
git clone https://github.com/seyola-community/seyola-paid.git my-seyola
cd my-seyola

# Initialize.
seyola-runtime init --workspace . --pack ./.seyola/pack

# Health check.
seyola-runtime doctor --workspace .

# Then open Claude Code and use the workflows.
claude

In Claude Code: /linkedin-writer, /brand-voice, /audience-profile-builder, /story-bank-builder.

Subcommands

| Command | Purpose | |---|---| | seyola-runtime --version | Print the runtime version. | | seyola-runtime --help | List all subcommands. | | seyola-runtime validate-pack --pack <path> | Validate a Seyola pack against its registries and schemas. | | seyola-runtime compile-plan --task <path> --pack <path> | Compile a TaskSpec into a deterministic WorkPlan. | | seyola-runtime run-step --plan <path> --step <id> --backend claude-code-local | Execute one WorkPlan step. | | seyola-runtime run-plan --task <path> --backend claude-code-local --output-dir <path> | Execute a full plan as a DAG. | | seyola-runtime init --workspace <path> --pack <path> | Initialize a Seyola workspace from a pack. | | seyola-runtime doctor --workspace <path> | Health-check a workspace. | | seyola-runtime bundle --pack <path> --runtime <path> --out <path> | Generate a Client Alpha distribution bundle. |

Run seyola-runtime <command> --help for command-specific options.

How it works

The runtime reads a Seyola pack (typed registries + skills + schemas), compiles a member's intent (a TaskSpec) into a deterministic WorkPlan, then executes each step against a backend. Today the only supported backend is claude-code-local, which spawns the official Claude Code CLI as a subprocess.

The runtime does NOT:

• Host or proxy any AI service.
• Store, collect, or transmit Claude credentials.
• Own member substrate (voice profiles, audience profiles, runs).
• Ship contracts or skill content (those live in the pack).

The pack is the product. The runtime is the executor.

Requirements

• Node.js 20+ — https://nodejs.org/
• Claude Code — https://claude.com/claude-code (installed and authenticated). Required for run-step and run-plan.
• A Seyola pack — typically the workspace cloned from https://github.com/seyola-community/seyola-paid (members only).

The runtime alone, without a pack, has no workflows to execute. Get the pack from the Seyola community.

License

Proprietary. See LICENSE. Use of this package is subject to the terms in the LICENSE file. The runtime is freely installable; the pack and methodology library are restricted to active Seyola members.

Support

For installation issues with this runtime: open an issue on the source repository.

For Seyola product questions, methodology, or member access: contact the Seyola community.