moai-session-info
Display comprehensive project and session information including Git status, SPEC progress, version details, and system resources. Use when starting new sessions, checking project status, reviewing project context, or when users ask "what's the status", "show project info", or "where are we".
When & Why to Use This Skill
The moai-session-info skill serves as a comprehensive project dashboard and context provider for Claude. It aggregates critical development data including Git repository status, SPEC progress tracking, versioning information, and real-time system resource metrics. By providing a 'single source of truth' for the project state, it enhances agentic workflow accuracy, prevents context loss during session handoffs, and streamlines the development lifecycle within the MoAI-ADK ecosystem.
Use Cases
- Session Initialization: Automatically retrieve a full project overview (Git branch, modified files, and SPEC status) when starting a new coding session to ensure the agent is fully synchronized.
- Project Progress Tracking: Monitor SPEC completion rates and pending milestones to maintain visibility on development velocity and project health.
- Pre-Operation Verification: Use as a safety check before performing major Git operations or implementing new features to confirm the current environment state.
- System Resource Monitoring: Keep track of CPU, memory, and disk usage during intensive development tasks to prevent environment performance bottlenecks.
- Version Management: Quickly identify current software versions and available updates to ensure the development toolchain remains up-to-date.
| name | moai-session-info |
|---|---|
| version | 1.0.0 |
| created | 2025-11-05 |
| updated | 2025-11-05 |
| status | active |
| description | Display comprehensive project and session information including Git status, SPEC progress, version details, and system resources. Use when starting new sessions, checking project status, reviewing project context, or when users ask "what's the status", "show project info", or "where are we". |
| keywords | [session-info, project-status, git-status, spec-progress, version-check, system-resources] |
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 languagepyproject.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