Back to Skills

marimo-serve

verified

This skill should be used when starting a marimo development server with hot reload. Triggers include: - Starting marimo server - Running marimo notebooks locally - Launching marimo development environment - Setting up hot reload for notebooks

View on GitHub

Marketplace

cc-marimo

dakesan/marimo-cc

Plugin

marimo-skills

Repository

dakesan/marimo-cc
1stars

skills/marimo-serve/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/dakesan/marimo-cc/blob/main/skills/marimo-serve/SKILL.md -a claude-code --skill marimo-serve

Installation paths:

Claude
.claude/skills/marimo-serve/
Powered by add-skill CLI

Instructions

# Marimo Development Server

Start a marimo development server with hot reload for interactive notebook development.

## Server Command

To start the server in background:

```bash
uv run marimo run --watch {filename} --port 2818
```

Use the Bash tool with `run_in_background: true` parameter to keep the server running.

## Configuration

- Default port: 2818
- Access URL: `http://localhost:2818`
- Hot reload: Enabled with `--watch` flag

## Verification

After starting the server:

1. Check running tasks with `/tasks` command
2. Verify server is accessible via WebFetch to `http://localhost:2818`
3. Use `lsof -i :2818` to confirm port is in use

## Workflow

1. Ensure the target notebook file exists
2. Start server with `run_in_background: true`
3. Edit notebook files with the Edit tool
4. Server automatically reloads on file changes
5. Fetch results via WebFetch when needed

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
875 chars