SlashCommand

Load and execute custom commands from markdown files.

Quick Start

main.py

from connectonion import SlashCommand

# Load command
cmd = SlashCommand.load("today")

# Get prompt
prompt = cmd.prompt

# List all commands
commands = SlashCommand.list_all()

Command File Format

Create .co/commands/today.md:

code

---
name: today
description: Daily email briefing
tools:
  - Gmail.search_emails
  - WebFetch
---
Summarize my important emails from today.
Focus on:
- Urgent requests
- Meeting invites
- Follow-ups needed

YAML Frontmatter

Field	Required	Description
name	Yes	Command name
description	Yes	Short description
tools	No	Allowed tools (all if omitted)

Tool Filtering

Limit which tools the command can use:

code

tools:
  - Gmail.search_emails    # Specific method
  - WebFetch               # Whole class
  - my_function            # Standalone function

Locations

Commands are loaded from:

.co/commands/*.md (user commands - priority)
commands/*.md (built-in commands)

API

main.py

# Load single command
cmd = SlashCommand.load("today")
cmd.name          # "today"
cmd.description   # "Daily email briefing"
cmd.prompt        # "Summarize my important..."
cmd.tools         # ["Gmail.search_emails", "WebFetch"]

# Filter tools for command
filtered = cmd.filter_tools(all_tools)

# List all available commands
commands = SlashCommand.list_all()
for cmd in commands:
    print(f"/{cmd.name} - {cmd.description}")

Diff Writer

TUI Components