Skip to content

ao2363/miso

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

MISO β€” Mission Inline Skill Orchestration

OpenClaw Skill Reaction Level Design System

Instant mission state awareness without opening a single chat.


Demo

MISO Demo

Real-time multi-agent orchestration in Telegram. No Web UI needed.


What is MISO?

MISO is an OpenClaw skill that implements a 4+1 layer UX model for mission-critical work. It leverages Telegram's rich reaction system to give you immediate state visibility at a glanceβ€”no need to open conversations to check progress.

Unlike traditional project management tools that require dashboards, refreshes, or manual status checks, MISO pushes state changes to the surface using emoji reactions and strategic message patterns. Your agents read SKILL.md and follow the patterns automaticallyβ€”no Python code required.


4+1 Layer UX Model

MISO organizes communication into four distinct layers, each optimized for speed and cognitive load:

Layer Element Purpose Speed
0 πŸ“Œ Pin Presence announcement Instant (chat open)
1 πŸ”₯πŸ‘€πŸŽ‰βŒ Reaction State identification Instant (chat list)
2 Message Body Detailed information Read when needed
3 Inline Buttons Actions Execute on interaction

The magic happens at Layer 1: You see mission state right in the chat list without opening any conversations.


Features

  • Zero-Dashboard Visibility β€” See all mission states from your chat list
  • Reaction-Based State Machine β€” Emoji reactions carry semantic meaning
  • OpenClaw Native β€” Drop it in your skills directory, configure once, done
  • Design System Compliant β€” Follows MISO's visual and formatting standards
  • WBS Master Ticket Pattern β€” Track complex work with strike-through updates
  • Phase Templates β€” Consistent, emoji-rich status formats for every phase
  • Extensive Reaction Mode β€” Full emoji reaction support required
  • No Code Required β€” Agents read patterns from SKILL.md and follow them

Quick Start

Install MISO

# Clone the repository
git clone https://github.com/shunsukehayashi/miso.git ~/.openclaw/skills/miso

# Or install via clawhub (if available)
clawhub install miso

Configure OpenClaw

Edit ~/.openclaw/openclaw.json to enable extensive reactions:

{
  channels: {
    telegram: {
      reactionLevel: "extensive"
    }
  }
}

Use MISO

  1. Start a mission with the MISO pattern
  2. Agents automatically apply reactions (πŸ”₯ in-progress, πŸ‘€ pending, πŸŽ‰ complete, ❌ failed)
  3. Track state from your chat listβ€”no need to open conversations
  4. Use inline buttons for actions (approve, reject, etc.)

That's it. No Python imports, no setup code. Just patterns that agents follow.


Phase Example

Here's a sample phase message following the MISO design system:

πŸ—οΈ Phase: Implementation

β€” Started 2026-02-17 Β· Estimated 2026-02-20 β€”
Status: πŸ”₯ In Progress (Day 2 of 4)

This phase covers the core feature development:
  ↳ Backend API endpoints
  ↳ Frontend components
  ↳ Integration testing

Next: Validation & Review phase
🌸 α΄˜α΄α΄‘α΄‡Κ€α΄‡α΄… ʙʏ ᴍΙͺʏᴀʙΙͺ

Key design elements:

  • Em dash (β€”) separators
  • Unicode bold where needed
  • Indented hierarchy with ↳
  • Sakura (🌸) footer
  • Reaction-friendly structure

Configuration

openclaw.json

{
  // Enable extensive reactions for full MISO support
  channels: {
    telegram: {
      reactionLevel: "extensive"
    }
  },

  // Optional: Configure MISO-specific settings
  skills: {
    miso: {
      enabled: true,
      reactionEmojis: {
        inProgress: "πŸ”₯",
        pending: "πŸ‘€",
        complete: "πŸŽ‰",
        failed: "❌",
        blocked: "🚫",
        approved: "βœ…",
        rejected: "πŸ‘Ž"
      }
    }
  }
}

Reaction Semantics

Emoji Meaning When to Use
πŸ”₯ In Progress Active work happening
πŸ‘€ Pending Waiting on something
πŸŽ‰ Complete Phase/mission done
❌ Failed Hit a blocker
🚫 Blocked Waiting on external dependency
βœ… Approved Green-lit to proceed
πŸ‘Ž Rejected Changes requested

WBS Master Ticket Example

Track complex work with strike-through updates:

πŸ“‹ WBS Master: E-Commerce Platform Migration

β€” Started 2026-02-10 Β· Target 2026-02-28 β€”
Status: πŸ”₯ In Progress (60%)

## Phase 1: Discovery [COMPLETE]
  ↳ ~~Audit current system~~
  ↳ ~~Define migration scope~~
  ↳ ~~Risk assessment~~

## Phase 2: Architecture [COMPLETE]
  ↳ ~~Design new data model~~
  ↳ ~~API specification~~
  ↳ ~~Infrastructure plan~~

## Phase 3: Implementation [IN PROGRESS]
  ↳ ~~Core backend services~~
  ↳ ~~User authentication module~~
  ↳ ~~Payment integration~~
  ↳ Order management system (active)
  ↳ Inventory sync
  ↳ ~~Frontend components~~
  ↳ ~~Admin dashboard~~
  ↳ Customer portal (active)

## Phase 4: Testing [PENDING]
  ↳ Unit tests
  ↳ Integration tests
  ↳ Load testing
  ↳ Security audit

## Phase 5: Launch [PENDING]
  ↳ ~~Staging deployment~~
  ↳ Production cutover
  ↳ Monitoring setup
  ↳ Rollback plan verification

Next: Testing phase kickoff
🌸 α΄˜α΄α΄‘α΄‡Κ€α΄‡α΄… ʙʏ ᴍΙͺʏᴀʙΙͺ

Design Rules

When following MISO patterns, remember:

  • Left-align only β€” No centering, no right alignment
  • No ASCII box diagrams β€” Use Markdown tables instead
  • Tables are OK β€” Markdown tables are allowed
  • Code blocks are OK β€” For config examples, code snippets, etc.
  • Emojis carry structure β€” Use them strategically
  • Em dash separators β€” Use β€” between sections
  • ↳ for hierarchy β€” Indicate nested items with ↳
  • 🌸 footer β€” Always end with the MISO signature

Credits

Created by Shunsuke Hayashi as part of the OpenClaw ecosystem.

Inspired by the need for mission-critical visibility without dashboard fatigue.


License

MIT License β€” See LICENSE for details.


Ready to transform your mission visibility? Install MISO and never wonder "what's the status?" again.

About

🍜 MISO β€” Mission Inline Skill Orchestration. Telegram-native Agentic UI framework for real-time multi-agent visualization.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages