ajbcoding/moai-session-info

Session Information Provider

Skill Metadata

| Field | Value | | ----- | ----- | | Version | 1.0.0 | | Tier | Alfred (Session Management) | | Auto-load | On session start or when status requested | | Purpose | Provide comprehensive project and session overview |

---

What It Does

Comprehensive session and project information provider that gives users complete context about their current MoAI-ADK project state, including Git status, SPEC progress, version information, and system resources.

Core capabilities:

• ✅ Project metadata and configuration display
• ✅ Git repository status and commit history
• ✅ SPEC progress tracking and completion metrics
• ✅ Version information and update availability
• ✅ System resource monitoring
• ✅ Checkpoint status and restoration options
• ✅ Session metrics and handoff information

---

When to Use

• ✅ When starting a new Claude Code session
• ✅ When checking project status and progress
• ✅ Before making significant changes or commits
• ✅ When users ask "what's the status", "show project info", "where are we"
• ✅ When reviewing project context and history
• ✅ Before running /alfred commands

---

Core Information Categories

1. Project Overview

🗿 Project: MoAI-ADK
📁 Location: /Users/goos/MoAI/MoAI-ADK
🌍 Language: 한국어 (Korean)
🔧 Mode: Team (GitFlow)
⚡ Toolchain: Python optimized

2. Version Information

📦 Current: v0.15.2
🆓 Update Available: v0.16.0
⬆️  Upgrade Command: pip install --upgrade moai-adk
📝 Release Notes: https://github.com/moai-adk/moai-adk/releases/tag/v0.16.0

3. Git Repository Status

🌿 Branch: develop (3 commits ahead of main)
📝 Changes: 5 modified, 2 added
🔨 Last Commit: feat: Complete skill consolidation (2 hours ago)
📊 Commit Hash: a1b2c3d

4. SPEC Progress

📋 Total SPECs: 15
✅ Completed: 12 (80%)
⏳ In Progress: 2
📝 Pending: 1
📊 Completion Rate: 80%

5. System Resources

🧠 Memory Usage: 2.4GB / 16GB (15%)
💾 Disk Space: 45GB free
🔄 CPU Usage: 12%
⚡ Session Duration: 45 minutes

6. Available Checkpoints

🗂️  Checkpoints: 3 available
   📌 auth-system-implementation (30 min ago)
   📌 skill-consolidation (2 hours ago)
   📌 feature-branch-workflow (yesterday)
↩️  Restore: /alfred:0-project restore

---

Quick Start Commands

Basic Status Check

# Simple project overview
Skill("moai-session-info")

Detailed Status with Metrics

# Comprehensive status with all details
Skill("moai-session-info")
# Response includes all categories above

Before Major Operations

# Always check status before:
# - /alfred:1-plan (planning new features)
# - /alfred:2-run (implementing changes)
# - git operations (commits, merges)

Skill("moai-session-info")
# Review status, then proceed with operation

---

Information Sources

The skill gathers information from multiple sources:

Project Configuration

• .moai/config.json - Project settings and language
• pyproject.toml - Package version and dependencies
• .git/ - Repository status and history

SPEC Tracking

• .moai/specs/ - SPEC documents and completion status
• SPEC metadata - Progress tracking and milestones

System Resources

• psutil - Memory and CPU usage
• File system - Disk space and project size
• Session metrics - Current session duration

Version Information

• Package registries - Latest available versions
• GitHub releases - Release notes and changelogs

---

Status Message Format

The skill generates structured status messages with consistent formatting:

🚀 MoAI-ADK Project Status

📋 Project Overview
   🗿 Project: {project_name}
   📁 Location: {project_path}
   🌍 Language: {language}
   🔧 Mode: {git_mode}

📦 Version Information
   📦 Current: {current_version}
   {update_information}
   📝 Release Notes: {release_url}

🌿 Git Repository
   🌿 Branch: {branch} ({commit_hash})
   📝 Changes: {file_changes}
   🔨 Last: {last_commit_message}

📊 SPEC Progress
   📋 Total: {total_specs}
   ✅ Completed: {completed_specs} ({percentage}%)
   ⏳ In Progress: {in_progress_specs}

🧠 System Resources
   🧠 Memory: {memory_usage}
   💾 Disk: {disk_space}
   ⚡ Session: {session_duration}

🗂️  Checkpoints
   {checkpoint_list}
   ↩️  Restore: /alfred:0-project restore

---

Integration with Alfred Commands

This skill is automatically invoked by:

SessionStart Hook Integration

# In session_start__show_project_info.py
# Automatically called when session starts
Skill("moai-session-info")

Command Integration

# Before /alfred:1-plan
if context == "planning":
    Skill("moai-session-info")  # Show current status

# Before /alfred:2-run
if context == "implementation":
    Skill("moai-session-info")  # Confirm project state

# Before git operations
if "git" in command:
    Skill("moai-session-info")  # Show repository status

---

Error Handling and Fallbacks

Graceful Degradation

The skill provides useful information even when some sources fail:

# If Git commands fail:
# Still show project info, version, and system resources

# If SPEC counting fails:
# Still show Git status and version information

# If network access fails:
# Still show local information (Git, SPECs, system)

Common Error Scenarios

• Git repository not found: Shows project info without Git details
• No .moai/config.json: Uses default settings and basic project detection
• Network unavailable: Shows local information only
• Permission denied: Provides read-only information where possible

---

Performance Considerations

Optimization Strategies

• Caching: Cache expensive operations (Git history, version checks)
• Timeouts: 5-second timeout for network operations
• Lazy Loading: Load detailed information only when requested
• Incremental Updates: Update only changed information

Resource Usage

• Memory: Minimal footprint (< 10MB)
• Network: Only for version checks (cached locally)
• Disk: Reads existing files, no modifications
• CPU: Lightweight operations, quick response times

---

Usage Examples

Example 1: Session Start

# User starts new Claude Code session
Skill("moai-session-info")

# Output:
🚀 MoAI-ADK Session Started

📋 Project Overview
   🗿 Project: MoAI-ADK
   📁 Location: /Users/goos/MoAI/MoAI-ADK
   🌍 Language: 한국어
   🔧 Mode: Team

📦 Version: v0.15.2 → v0.16.0 available
📝 Release Notes: https://github.com/...

🌿 Branch: develop (3 ahead)
📝 Changes: 5 modified, 2 added
📋 SPEC Progress: 12/15 (80%)

Example 2: Pre-Implementation Check

# User wants to implement new feature
"/alfred:2-run SPEC-AUTH-001"

# Alfred automatically calls:
Skill("moai-session-info")

# User sees status before implementation begins

Example 3: Status Query

# User asks: "what's our current status?"
Skill("moai-session-info")

# Complete project status displayed

---

End of Skill | Optimized for quick status checks and session context