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.