AgentSkillsCN

moru

此技能适用于 Moru 云沙盒的相关概念、CLI 命令,以及通用指导。Moru 提供隔离的 Firecracker 微虚拟机,配备专用的 CPU、内存与文件系统,确保代码安全执行。本技能涵盖:安装 Moru CLI、使用 `moru auth login` 进行身份验证、通过 `moru sandbox create` 创建沙盒、使用 `moru sandbox run` 运行命令、借助 `moru template` 管理模板、通过 `moru volume` 操作持久化存储卷,以及深入理解沙盒、模板与存储卷等核心概念。当用户咨询 Moru 架构、CLI 使用方法、环境变量(MORU_API_KEY、MORU_ACCESS_TOKEN)、资源限制等问题,或在不确定应使用哪个 SDK 时,此技能便是您的不二之选。若要编写带有沙盒的 Python 代码,请改用 moru-python;若要编写 JavaScript/TypeScript 代码,请改用 moru-javascript。触发条件包括:“moru cli”、“moru sandbox”、“moru template”、“moru volume”、“moru auth”、“install moru”、“what is moru”、“moru concepts”。

SKILL.md
--- frontmatter
name: moru
description: "Use this skill for Moru cloud sandbox concepts, CLI commands, and general guidance. Moru provides isolated Firecracker microVMs with dedicated CPU, memory, and filesystem for safe code execution. This skill covers: installing the Moru CLI, authenticating with `moru auth login`, creating sandboxes with `moru sandbox create`, running commands with `moru sandbox run`, managing templates with `moru template`, working with persistent volumes via `moru volume`, and understanding core concepts like sandboxes, templates, and volumes. Use this skill when users ask about Moru architecture, CLI usage, environment variables (MORU_API_KEY, MORU_ACCESS_TOKEN), resource limits, or when unsure which SDK to use. For writing Python code with sandboxes, use moru-python instead. For JavaScript/TypeScript code, use moru-javascript instead. Triggers on: 'moru cli', 'moru sandbox', 'moru template', 'moru volume', 'moru auth', 'install moru', 'what is moru', 'moru concepts'."

Moru Cloud Sandboxes

Isolated Firecracker microVMs with dedicated CPU, memory, and filesystem for safe code execution.

When to Use Which Skill

SkillUse When
moru (this)CLI, general concepts, architecture
moru-pythonPython SDK (pip install moru)
moru-javascriptJavaScript/TypeScript SDK (npm install @moru-ai/core)

Core Concepts

Sandbox

Isolated VM with up to 2 vCPUs, 4GB RAM, 10GB disk. Default timeout is 1 hour.

Template

Pre-built environment with packages installed. Sandboxes start instantly from templates.

Volume

Persistent storage that survives sandbox restarts. Mount to /workspace, /data, /mnt, or /volumes.

CLI Quick Start

bash
# Install
curl -fsSL https://moru.io/cli/install.sh | bash

# Login
moru auth login

# Run command in sandbox
moru sandbox run base echo 'hello world'

# Interactive sandbox
moru sandbox create python

# List/kill
moru sandbox list
moru sandbox kill sbx_abc123

CLI Reference

Sandbox Commands

bash
moru sandbox create [template]      # Create interactive sandbox
moru sandbox run [template] <cmd>   # Run command, auto-cleanup
moru sandbox exec <id> <cmd>        # Execute in existing sandbox
moru sandbox list                   # List sandboxes
moru sandbox kill <id>              # Kill sandbox
moru sandbox logs <id> [--follow]   # View logs
moru sandbox metrics <id>           # View CPU/memory/disk

Template Commands

bash
moru template init                              # Initialize template project
moru template create <name> --dockerfile ./Dockerfile
moru template list
moru template delete <name>

Volume Commands

bash
moru volume create --name <name>
moru volume list
moru volume delete <name>

Environment Variables

VariableDescription
MORU_API_KEYAPI key (get from https://moru.io/dashboard?tab=keys)
MORU_ACCESS_TOKENAccess token from moru auth login

Resource Limits

ResourceMaximum
vCPUs2
Memory4 GB
Disk10 GB
Timeout1 hour
Concurrent Sandboxes20 per team