Ailang

AILANG

BEFORE YOU WRITE ANY CODE

Run this command first - it outputs the current syntax rules and templates:

ailang prompt

This is the source of truth for AILANG syntax. Do not guess at syntax.

Session Start

# 1. Check for messages from other agents
ailang messages list --unread

# 2. Load current syntax (CRITICAL!)
ailang prompt

# 3. Verify AILANG is installed
ailang --version

# 4. If debugging, tracing, or toolchain help needed:
#    ailang devtools-prompt

Development Workflow

┌──────────────────────────────────────┐
│ 1. Run: ailang prompt                │
│    Read the template and examples    │
└──────────────────────────────────────┘
                 ↓
┌──────────────────────────────────────┐
│ 2. Write code following template     │
│    module myproject/mymodule         │
│    export func main() -> () ! {IO}   │
└──────────────────────────────────────┘
                 ↓
┌──────────────────────────────────────┐
│ 3. Type-check (fast feedback)        │
│    ailang check file.ail             │
└──────────────────────────────────────┘
                 ↓
┌──────────────────────────────────────┐
│ 4. Run with capabilities             │
│    ailang run --caps IO --entry main │
└──────────────────────────────────────┘
                 ↓
        Fix errors, repeat

CLI Quick Reference

Exploring the Standard Library

The CLI is the source of truth. Use ailang docs for module-level docs and ailang builtins list --verbose for all builtins:

# List all available stdlib modules
ailang docs --list

# Show full exports + signatures for a module (PREFER THIS)
ailang docs std/string
ailang docs std/json
ailang docs std/stream

# Full builtins with examples and signatures
ailang builtins list --verbose --by-module

# Search for specific function
ailang builtins list --verbose | grep -A 10 "httpGet"

Key stdlib modules (v0.10.0):

Note: This skill provides guidance, but ailang prompt and ailang docs are always more up-to-date.

Finding Working Examples (v0.6.2+)

Search 97 working code examples directly from the CLI:

# Search for examples by keyword (flags BEFORE query!)
ailang examples search "pattern matching"
ailang examples search --limit 5 "recursion"

# View a specific example with metadata and expected output
ailang examples show adt_option
ailang examples show fold_reduce --expected

# List examples by tag
ailang examples list --tags adt
ailang examples list --tags recursion

# See all available tags
ailang examples tags

Search scoring: Tag match (1.0) > Description (0.95) > Content (0.80) > Partial (0.60-0.70)

When to use:

• Learning AILANG patterns: ailang examples list --tags recursion
• Checking syntax: ailang examples search "match"
• Finding working code: ailang examples show NAME --run

Flags MUST come before filename:

ailang run --caps IO --entry main file.ail   # Correct
ailang run file.ail --caps IO                # WRONG

Capabilities

Practical Examples

Offer to create these working examples for users:

AI Debate Example

module my_debate
import std/ai (call)
import std/ai (call)

export func main() -> () ! {IO, AI} {
  println("=== AI Debate ===");
  let optimist = call("Argue FOR AI benefits in 2 sentences");
  println("Optimist: " ++ optimist);
  let skeptic = call("Argue AGAINST AI risks in 2 sentences");
  println("Skeptic: " ++ skeptic)
}

File Summarizer Example

module summarizer
import std/ai (call)
import std/fs (readFile)

export func main(path: string) -> () ! {IO, FS, AI} {
  let content = readFile(path);
  let summary = call("Summarize in 3 bullets: " ++ content);
  println(summary)
}

Packages & Registry

Install and use community packages from the AILANG registry:

# Discover packages
ailang search "auth"              # Search by keyword
ailang search --tag gcp           # Browse by tag
ailang pkg-docs sunholo/auth      # View AI usage guide for a package

# Use a package
ailang install sunholo/auth@0.1.0
ailang add --registry sunholo/auth@0.1.0  # Add as dependency

# Publish a package
ailang init package --name vendor/name    # Create ailang.toml
ailang publish --dry-run                  # Preview
ailang publish

When Stuck

• Run ailang devtools-prompt for full toolchain reference (debugging, tracing, eval, chains, coordinator)
• Run ailang repl for interactive testing
• See common_patterns.md for patterns
• See cli_reference.md for full CLI docs
• See editor_support.md for VS Code, Vim, Neovim setup
• Check the ailang-debug skill for error fixes
• Docs: https://ailang.sunholo.com/docs/guides/getting-started

Done? Notify

ailang messages send user "Task completed" --from "my-agent" --title "Status"

Converted and distributed by TomeVault — claim your Tome and manage your conversions.