Check and process messages from autonomous AILANG agents. Use when starting a session, after agent handoffs, or when checking for completion notifications.
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
Check and process messages from autonomous AILANG agents. Use when starting a session, after agent handoffs, or when checking for completion notifications.
Agent Inbox
Check for messages from autonomous agents at session start and process completion notifications.
Quick Start
Most common usage:
# List all messages
ailang messages list
# Show only unread messages
ailang messages list --unread
# Read full message content
ailang messages read MSG_ID
# Acknowledge (mark as read)
ailang messages ack MSG_ID
ailang messages ack --all
# Send a message
ailang messages send user "Your message" --title "Title" --from "agent-name"# Send bug/feature to GitHub (for cross-instance visibility)
ailang messages send user "Bug report" --type bug --github
Session starts - First action in every Claude Code session (required by CLAUDE.md)
- When you've sent work to autonomous agents
After handoffs
Periodic checks - User asks "any updates from agents?"
Debugging - To see agent communication history
Storage Backend
All messages stored in SQLite database:
Location: ~/.ailang/state/collaboration.db
Accessible via: CLI (ailang messages) and Collaboration Hub dashboard
Message statuses: unread, read, archived, deleted
Available Commands
List Messages
ailang messages list # All messages
ailang messages list --unread # Only unread
ailang messages list --inbox user # Filter by inbox
ailang messages list --from agent-name # Filter by sender
ailang messages list --json # JSON output
ailang messages list --limit 50 # Limit results
Read Full Message
ailang messages read MSG_ID # Full content, marks as read
ailang messages read MSG_ID --peek # View without marking read
ailang messages read MSG_ID --json # JSON output
Acknowledge Messages
ailang messages ack MSG_ID # Mark specific message as read
ailang messages ack --all # Mark all as read
ailang messages ack --all --inbox user # Mark all in inbox as read
Un-acknowledge (Mark Unread)
ailang messages unack MSG_ID # Move back to unread
ailang messages import-github # Import from default repo
ailang messages import-github --repo owner/repo # Specific repo
ailang messages import-github --labels bug,help# Filter by labels
ailang messages import-github --dry-run # Preview without importing
Workflow
1. Session Start Check (REQUIRED)
SessionStart hook runs automatically and shows unread messages.
If messages exist:
Read and summarize each message to user
Identify message type (completion, error, handoff)
Ask user if they want action taken
Acknowledge after handling: ailang messages ack --all
2. Process Completion Notifications
When agent reports completion:
# 1. Read the full message
ailang messages read MSG_ID
# 2. Review results mentioned in payloadls -la eval_results/baselines/v0.4.2/
# 3. Report to userecho"Sprint complete! Results at: eval_results/baselines/v0.4.2/"# 4. Acknowledge after processing
ailang messages ack MSG_ID
3. Handle Error Reports
When agent reports errors:
# 1. Read the full error details
ailang messages read MSG_ID
# 2. Check logs if mentionedcat .ailang/state/logs/sprint-executor.log
# 3. Diagnose and report to userecho"Agent encountered error: Tests failing at milestone 3/5"# 4. Either fix manually or send corrective instructions
4. Respond to Agent or User
# Send response to an agent
ailang messages send sprint-executor "Approved, proceed" \
--title "Approval" --from "user"# Send notification to user inbox
ailang messages send user "Issue resolved" \
--title "Status update" --from "claude-code"
GitHub Integration (Bi-directional)
Message Types and Routing
Type
Purpose
Goes to GitHub?
bug
Bug report
Yes (with --github)
feature
Feature request
Yes (with --github)
general
Coordination
No (local only)
Routing guidance:
Bugs and features → Use --github for visibility across all AILANG instances
Coordination messages → Local only, for agent-to-agent communication
Instructions from humans → Create GitHub issues, they'll be imported automatically
Sending to GitHub (Agent → GitHub)
# Bug reports and feature requests go to GitHub for visibility
ailang messages send user "Parser crash" --type bug --github
ailang messages send user "Need async support" --type feature --github
Importing from GitHub (GitHub → Local)
# Runs automatically on session start (if auto_import: true in config)
ailang messages import-github
# Or manually with filters
ailang messages import-github --labels help-wanted
Human Instructions via GitHub
You can write instructions as GitHub issues and have agents pick them up:
Create issue on GitHub with ailang-message label
Next session, import-github runs automatically
Issue appears in agent's inbox as a message
Agent reads and acts on the instructions
Configuration
Create ~/.ailang/config.yaml:
github:expected_user:YourGitHubUsername# REQUIRED: Must match gh auth statusdefault_repo:sunholo-data/ailang# Default repo for issuescreate_labels:-ailang-messagewatch_labels:-ailang-messageauto_import:true# Auto-import on session start
Prerequisites:
Install GitHub CLI: brew install gh
Authenticate: gh auth login
Check account: gh auth status
Switch if needed: gh auth switch --user USERNAME
Auto-label creation: Labels are automatically created if they don't exist: