PRODUCT / rikoko-mcp

rikoko-mcp

Your agent. Your ideas. A video workflow in one conversation.

01 / INSTALL

One prompt. Your agent handles setup.

Copy this prompt into Codex, Hermes or Claude Code with terminal access. Your agent checks the environment, installs rikoko and verifies the connection.

AGENT PROMPT

Install rikoko-mcp for my current agent using these guides:
https://rikoko.ai/install
https://rikoko.ai/clients

Detect my environment, inspect the installer, back up config and preserve other MCP servers. Explain version conflicts before changes. Follow the client-specific steps, including Hermes. Verify tools and capabilities without paid generation; report connection status and any manual steps. On Windows, the native PowerShell installer is an experimental preview without Windows validation. Follow the release guide, or use an existing WSL distribution and configure the agent in that same distribution.

macOS / Linux / WSL. Native Windows installation is in preview and has not been tested on Windows.

Using Claude Desktop? Give this prompt to a terminal-enabled agent on the same computer and ask it to configure Claude Desktop. You may need to approve system permissions or restart the client.

Prefer to install it yourself?

macOS / Linux / WSL

Run this command in a macOS, Linux or WSL terminal. It downloads rikoko, prepares dependencies and connects detected Codex or Claude clients.

TERMINAL

curl -fsSL https://rikoko.ai/install.sh | bash

Windows · PowerShell

The native PowerShell installer is available as an experimental preview for Windows 10/11 x64. Download it and follow the release installation guide; Windows installation has not been tested.

Download PowerShell installer ↗

Already using WSL? Run this command in PowerShell. It installs rikoko inside your default WSL distribution.

TERMINAL

wsl.exe -- bash -lc "curl -fsSL https://rikoko.ai/install.sh | bash"

Requires an installed, initialized WSL distribution with Bash and curl. Use Codex or Claude Code in that same distribution. This does not configure Windows desktop clients. If WSL is not ready, set it up first and reopen PowerShell.

For Hermes, follow the client guide on the machine running Hermes, then reload its MCP connection.

Agent connection guide ↗

macOS and Linux/WSL · arm64 / x64 · Bash + curl. Missing dependencies may require administrator permission. Windows users should run the command inside WSL.

The installer can prepare Node.js 22.19+, uv, Python 3.12 and FFmpeg. macOS installation has been tested; Linux/WSL and machines with no dependencies have not been fully verified.

The Bash installer supports managed upgrades with backups and rollback. Finish active jobs, close clients and keep the original installation directory. Native Windows upgrades are not supported in this preview.

Release installation guide ↗

Public releasev0.1.32Download source package ↗SHA-256 ↗Release notes ↗

Local editing needs no model API key. AI generation requires a configured provider and a separate budget.

02 / IN ACTION

From reference to yours, in Hermes.

Watch a real rikoko workflow inside Hermes: start with a reference, describe your changes and receive the video in the conversation.

Hermes demo · Reference to yours

This demo shows a configured environment. Available tools and generation models depend on your installed release and provider setup.

Check the connection

Send this in your agent conversation. Confirm it can call rikoko before starting a video task.

AGENT PROMPT

Use rikoko to check the available capabilities and report whether the local service is connected. Do not start a generation task.

03 / CREATE

Make your first video

Bring a short clip
Attach your own video in the agent, or provide a local file it can access.
Describe one edit
Start with a simple trim using existing footage. Copy the brief below into your agent.
Review and continue
Open the returned video or media link, then request your next change in the same conversation.

AGENT PROMPT

Use rikoko to trim my attached video to its first 5 seconds, keeping the original audio. Export an MP4 and return the video or a playable link here. Use only my existing footage; do not generate new media. If you cannot access the attachment, tell me how to provide it.

Want AI-generated shots next? Configure your provider first. The public installer does not include a generation subscription.

Full first-video tutorial ↗Model configuration ↗Explore use cases ↗

Need help connecting?

Find connection options, tutorials and API details in the docs.

Integration docs ↗