butterfly

Guide Butterfly CLI server, session, and log operations for developers.

7|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/dannyxiaocn/butterfly-agent --skill butterfly
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: butterfly
Source: https://github.com/dannyxiaocn/butterfly-agent/tree/main/skillhub/butterfly
Command: npx skills add https://github.com/dannyxiaocn/butterfly-agent --skill butterfly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Butterfly CLI usage and development guidance helps users operate the Butterfly agent-runtime and contribute to its codebase, streamlining both operational use and code-level collaboration.

Core Features & Use Cases

  • Guidance for using the Butterfly CLI to start servers, chat with agents, manage sessions, and inspect logs.
  • Developer-focused content outlining the runtime, providers, tool/skill engine, and how to contribute changes to docs and tests.
  • Practical workflows for setting up entities, prompts, tools, and skills within the filesystem-based workflow.

Quick Start

Start the Butterfly server and begin a chat session to observe the runtime, sessions, and prompts in action.

Frequently Asked Questions about butterfly

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

FAQPage Schema
How do I start a Butterfly CLI server and chat with agents?▼

To run an agent runtime with the Butterfly CLI, launch the server and begin a chat session to observe the session lifecycle, prompts, and tooling in action.

How does the Butterfly agent runtime manage sessions and prompts?▼

The Butterfly agent runtime manages sessions and prompts using a Python-based, filesystem-driven architecture to handle the session lifecycle, create entities, and execute tooling workflows.

Can I use the Butterfly CLI to inspect agent runtime logs and manage entities?▼

Yes, you can use the Butterfly CLI to view logs and set up entities within the filesystem-driven architecture to manage agent operations and tooling workflows.

How do I contribute changes to the Butterfly codebase and skill engine?▼

To contribute to the Butterfly codebase and skill engine, use the developer-focused guidance to modify the runtime providers and tool engine, then submit improvements to docs and tests.

What is the best way to set up tools and skills in a filesystem-driven agent architecture?▼

The best way to set up tools and skills in a filesystem-driven agent architecture is to create entities and prompts directly within the filesystem to execute tooling workflows.