Edisyl Tools

CLI installer and AI assistant skill for Edisyl — Flipside's platform for building and running AI agent fleets.

Installation

1. Install the Skill

Add the Edisyl skill to your AI coding assistant:

npx skills add FlipsideCrypto/edisyl-tools

Or manually copy skills/edisyl/ to your .claude/skills/ directory.

2. Install the CLI

curl -fsSL https://raw.githubusercontent.com/FlipsideCrypto/edisyl-tools/main/install.sh | sh

3. Authenticate

edisyl login

Verify your setup:

edisyl whoami

Quick Start

The best way to use Edisyl is through an AI coding assistant like Claude Code. The skill teaches your assistant the core surfaces of edisyl:

1. Agent configs and skills — author and deploy from YAML
2. Fleets, teams, and missions — compose deployed agents into fleets and run multi-agent missions
3. Data sources — connect Snowflake / Postgres / BigQuery / Databricks / Redshift / MySQL and kick the introspect → enrich pipeline
4. Stratum — natural-language → SQL resolve, plus the indexing/curation surface (snapshots, learning candidates, model readiness, resolution traces)

Using with Claude Code

1. Open Claude Code in any directory
2. Ask about fleets and missions:

"List the fleets in my org and run a mission on the analytics fleet to summarize last week's USDC activity."

"Author a new agent that classifies wallet behavior, validate it, and push it."

"Add the wallet-watcher agent to the analytics-fleet team."

Claude Code will use the Edisyl skill to:

• Discover fleets and their teams
• Author/validate/push agent and skill YAML
• Start missions and follow their plan trees

Direct CLI Usage

You can also drive the CLI directly:

# Authoring
edisyl agent init my-agent
edisyl agent push agent.yaml
edisyl skills init my-skill
edisyl skills push skill.yaml

# Fleets and teams
edisyl fleet list
edisyl fleet team add <fleet-id> --team <team-id>

# Missions and chat
edisyl mission create <fleet> "Summarize USDC activity last week" --follow
edisyl mission tree <mission-id>
edisyl chat <fleet>

# Data sources — kicks introspect + Stratum enrichment on create
edisyl data-sources test-connection --type postgres --config-file db.json
edisyl data-sources create --name "Demo PG" --type postgres --config-file db.json
edisyl stratum status -d <data-source-id>

# Stratum — natural-language → SQL
edisyl stratum resolve "Top 10 tokens by transfer count last 7 days" \
  -d <data-source-id> --wait --rows 5
edisyl stratum trace <resolution-id>            # diagnose what happened
edisyl stratum candidates list                  # review optimizer suggestions

For everything else (queries, sessions, uploads, api-keys), run:

edisyl llm onboard

How the Skill Works

When you install the Edisyl skill, your AI assistant learns:

1. Where to start: edisyl llm onboard — the navigation guide built into the CLI
2. Agent and skill authoring: edisyl llm agents, edisyl llm skills
3. Fleet/mission orchestration: how to compose teams, kick off missions, follow plan trees
4. Data-source onboarding: validate creds, create a data source, watch the introspect → enrich pipeline
5. Stratum: resolve NL questions to SQL, inspect snapshots/indexes, debug cascade tiers, review learning candidates, trace past resolutions

The skill is intentionally lean — the heavy reference content lives inside the CLI itself via edisyl llm <topic>, so it stays in sync with the deployed CLI version.

What's in This Repo

edisyl-tools/
├── skills/
│   └── edisyl/         # AI assistant skill for fleets + agent/skill authoring
│       ├── SKILL.md    # Main skill definition
│       ├── README.md   # Skill overview
│       ├── metadata.json
│       └── scripts/    # check-auth.sh
├── install.sh          # CLI installer
└── README.md

Updating

Check for skill updates:

npx skills check

Update to the latest version:

npx skills update

Update the CLI:

edisyl update         # latest stable
edisyl update --dev   # latest dev build

Source

The CLI is built from go/cmd/edisyl/ in FlipsideCrypto/mono. Releases are produced by the Release edisyl CLI workflow on tag edisyl-v*.

License

MIT