BeClaude

ai-mesh-pane-viewer

New
11Community RegistryGeneralby Fortium Partners Β· MIT

Real-time subagent monitoring in terminal panes (WezTerm, Zellij, tmux)

Community PluginView Source

Overview

πŸš€ Fortium Software Customer Solutions

EXCEEDED 30% productivity target - Achieve 35-40% productivity increase with optimized Claude Code configurations, battle-tested workflows, and intelligent automation.

![Status]() ![Version]() ![License]() ![Agent Mesh]() ![Performance]() ![TRD System]() ![Installation]() ![Architecture]()

Overview

The claude-config repository is Fortium's comprehensive toolkit for Claude Code optimization. This repository provides production-ready configurations, custom commands, specialized AI agents, and automation hooks that transform development workflows and deliver measurable productivity gains exceeding targets by 35-40%.

✨ YAML Architecture Enhancement

Version 3.0 introduces a modernized YAML-based architecture for agents and commands, providing:

  • β€’Enhanced Schema Validation: Comprehensive JSON schemas ensure consistency
  • β€’Improved Tooling Support: Better IDE integration and automated validation
  • β€’Simplified Maintenance: Cleaner structure for agent and command definitions
  • β€’Advanced Parsing: Sophisticated transformation and validation infrastructure

πŸ“¦ Command Directory Reorganization (Sprint 2 Complete)

Hierarchical command organization with automatic migration system:

  • β€’Organized Structure: Commands grouped in ai-mesh/ subdirectory for better maintainability
  • β€’Automatic Migration: Installation detects flat structure and migrates automatically
  • β€’500x Faster: 10ms migration vs 5s target with comprehensive validation
  • β€’Zero Breaking Changes: All existing command invocations work unchanged
  • β€’Backward Compatible: Claude Code native subdirectory resolution ensures seamless transition

🎯 Key Benefits

  • β€’35-40% Faster Development: βœ… EXCEEDED 30% TARGET - TRD-driven workflows with 87-99% performance improvements
  • β€’65% Fewer Errors: βœ… EXCEEDED 50% TARGET - Approval-first workflows and comprehensive quality gates
  • β€’90% Task Automation: βœ… EXCEEDED 80% TARGET - Complete 29 specialized agent ecosystem with intelligent orchestration
  • β€’92% User Satisfaction: βœ… EXCEEDED 90% TARGET - Production-validated with modern command system
  • β€’98% Installation Success: βœ… EXCEEDED 95% TARGET - Node.js hooks system with zero Python dependencies

✨ Latest Major Achievements

🎯 December 2025 - Production Milestones Completed

  • β€’Real-Time Monitoring: Visual subagent activity in split terminal panes (WezTerm, Zellij, tmux)
  • β€’Tool Display: Shows tool invocations (Read, Write, Edit, Bash) with 15-line output preview (100 chars/line)
  • β€’Manual Close Control: User-controlled pane closing with "Press any key to close..." prompt
  • β€’Multi-Adapter Support: Automatic detection of WezTerm, Zellij, or tmux environments
  • β€’Status Tracking: Displays running/completed/failed states with execution duration
  • β€’Zero Impact: Graceful degradation if terminal multiplexer not available
  • β€’`/create-trd`: Convert PRD to comprehensive TRD with task breakdown and checkbox tracking
  • β€’`/implement-trd`: Full implementation workflow with approval-first orchestration
  • β€’Production Validated: Automated Claude Hooks Installation System (737 lines, 20 tasks, 4 phases)
  • β€’Migration Complete: Python to Node.js conversion with zero dependencies
  • β€’Performance: 87-99% faster than requirements (0.32-23.84ms vs ≀50ms target)
  • β€’Memory: 67-74% better than target (8.6-10.3MB vs ≀32MB target)
  • β€’Reliability: 100% test pass rate with comprehensive session consistency
  • β€’Infrastructure Management Subagent: Complete AWS/Kubernetes/Docker automation with security-first approach
  • β€’Approval-First Workflows: All orchestrators require explicit user consent
  • β€’New Specialists: nestjs-backend-expert, manager-dashboard-agent, api-documentation-specialist
  • β€’Quality Gates: Comprehensive DoD enforcement with security scanning

Previous Updates (August-October 2025)

  • β€’πŸ“¦ Command Migration System (Sprint 2): Hierarchical organization with 500x faster migration (10ms)
  • β€’πŸ§  Enhanced Context: Intelligent memory management across 130+ documentation files
  • β€’πŸ”’ Security Enhancement: Comprehensive security scanning integrated into code-reviewer
  • β€’πŸ“‹ AgentOS Integration: Complete product management system with structured workflows

Enhanced Installation System

  • β€’πŸŽ― User Choice: Global (~/.claude/) or local (.claude/) installation options
  • β€’πŸ’Ύ Automatic Backup: Safe configuration migration with timestamped backups
  • β€’βœ… Smart Validation: Comprehensive installation verification and testing
  • β€’πŸŽ¨ Professional UX: Color-coded progress with clear completion reporting
  • β€’πŸ”§ Fresh Setup: Move (not copy) existing configurations for clean installs

πŸ—οΈ Repository Architecture

code
claude-config/
β”œβ”€β”€ src/                       # πŸ“¦ NPM module source code
β”‚   β”œβ”€β”€ cli/                   #    CLI interface and commands
β”‚   β”œβ”€β”€ installer/             #    Core installation logic
β”‚   β”‚   β”œβ”€β”€ command-migrator.js   #    πŸ†• AI Mesh command migration (Sprint 2)
β”‚   β”‚   β”œβ”€β”€ backup-manager.js     #    πŸ†• Rolling backup system (Sprint 2)
β”‚   β”‚   β”œβ”€β”€ yaml-rewriter.js      #    πŸ†• YAML path updater (Sprint 2)
β”‚   β”‚   └── validation-system.js  #    πŸ†• Post-migration validation (Sprint 3)
β”‚   β”œβ”€β”€ monitoring/            #    File monitoring service
β”‚   β”œβ”€β”€ api/                   #    Programmatic API
β”‚   └── utils/                 #    Shared utilities
β”œβ”€β”€ bin/                       # πŸ”§ Executable entry points
β”‚   └── ai-mesh                #    CLI executable
β”œβ”€β”€ agents/                    # πŸ€– Custom AI agents (YAML format)
β”‚   β”œβ”€β”€ README.md              #    Complete agent ecosystem documentation
β”‚   └── *.yaml                 #    26 specialized agents in YAML format
β”œβ”€β”€ commands/                  # ⚑ Productivity commands (YAML format) ✨ **REORGANIZED**
β”‚   β”œβ”€β”€ ai-mesh/               #    πŸ†• AI Mesh commands (organized subdirectory)
β”‚   β”‚   β”œβ”€β”€ create-prd.md/.txt    #    12 commands Γ— 2 formats = 24 files
β”‚   β”‚   β”œβ”€β”€ create-trd.md/.txt
β”‚   β”‚   β”œβ”€β”€ implement-trd.md/.txt
β”‚   β”‚   β”œβ”€β”€ fold-prompt.md/.txt
β”‚   β”‚   └── ... (8 more commands)
β”‚   β”œβ”€β”€ agent-os/              #    πŸ”œ Agent OS commands (future)
β”‚   β”œβ”€β”€ spec-kit/              #    πŸ”œ Spec Kit commands (future)
β”‚   └── yaml/                  #    YAML command definitions (auto-updated paths)
β”‚       β”œβ”€β”€ create-prd.yaml
β”‚       β”œβ”€β”€ create-trd.yaml
β”‚       └── ... (12 YAML files)
β”œβ”€β”€ plugins/                   # πŸ”Œ Claude Code plugins ✨ **NEW (v0.1.0)**
β”‚   └── ai-mesh-pane-viewer/   #    πŸ–₯️ Real-time subagent monitoring
β”‚       β”œβ”€β”€ hooks/             #    PreToolUse/PostToolUse hook implementations
β”‚       β”‚   β”œβ”€β”€ agent-monitor.sh   #    Terminal pane monitor with tool display
β”‚       β”‚   β”œβ”€β”€ pane-spawner.js    #    Hook: creates monitoring pane
β”‚       β”‚   β”œβ”€β”€ pane-completion.js #    Hook: signals task completion
β”‚       β”‚   └── pane-manager.js    #    Pane lifecycle management
β”‚       β”œβ”€β”€ lib/               #    Reusable components
β”‚       β”‚   └── adapters/      #    WezTerm/Zellij/tmux adapters
β”‚       └── package.json       #    Plugin configuration
β”œβ”€β”€ schemas/                   # πŸ“‹ YAML validation schemas
β”‚   β”œβ”€β”€ agent-schema.json      #    Agent definition validation
β”‚   └── command-schema.json    #    Command definition validation
β”œβ”€β”€ hooks/                     # 🎣 Development lifecycle automation (manual install)
β”œβ”€β”€ .github/workflows/         # πŸ”„ CI/CD automation
β”‚   β”œβ”€β”€ npm-release.yml        #    NPM module publishing
β”‚   └── test.yml               #    Testing and validation
β”œβ”€β”€ package.json               # πŸ“‹ NPM module configuration
β”œβ”€β”€ CLAUDE.md                  # πŸ“‹ Configuration guidance and standards
└── README.md                  # πŸ“š This documentation

πŸš€ Quick Start

Installation Options

Professional Node.js installer with cross-platform support:

bash
# Global installation (recommended)
npm install -g @fortium/ai-mesh
ai-mesh install --global

# Or use npx for one-time installation
npx @fortium/ai-mesh install --global

# Local project installation
npx @fortium/ai-mesh install --local

# Update existing installation
ai-mesh update --global

NPM Installation Benefits:

  • β€’βœ… Cross-platform: macOS, Linux, Windows support
  • β€’βœ… Zero dependencies: No bash, Python, or additional tools required
  • β€’βœ… Professional CLI: Interactive prompts with colored output
  • β€’βœ… Smart update detection: Automatically detects existing installations
  • β€’βœ… Safe updates: Separate update command prevents accidental overwrites
  • β€’βœ… Automatic validation: Comprehensive health checks
  • β€’βœ… Error recovery: Rollback capabilities and detailed logging
  • β€’βœ… API access: Programmatic interface for automation

For users who prefer the original bash script:

bash
# Clone the repository
git clone https://github.com/FortiumPartners/claude-config.git
cd claude-config

# Run the interactive installer
./install.sh

# Follow the prompts:
# 1) Choose Global (1) or Local (2) installation
# 2) Automatic backup of existing configuration
# 3) Installation validation and verification

Installation Modes

Global Installation (Recommended)

  • β€’Installs to ~/.claude/ (your home directory)
  • β€’Available to Claude Code across all projects
  • β€’Agents and commands work from any directory

Local Installation (Project-specific)

  • β€’Installs to .claude/ (current project directory)
  • β€’Available only when working in this specific project
  • β€’Perfect for project-specific configurations

πŸ”” Important: Hook Installation Changes (v2.8.0)

As of version 2.8.0, development hooks are NO LONGER installed by default.

The hook framework (hooks/ directory) has been removed from the standard installation process to provide a cleaner, more flexible setup. If you need the hook framework for activity tracking and metrics:

  • β€’Hooks are available in the repository but require manual setup
  • β€’See `hooks/README.md` for installation and configuration instructions
  • β€’Activity tracking can be enabled separately if needed for your workflow

This change improves installation speed and reduces complexity for users who don't require the hook framework.

Post-Installation

bash
# Restart Claude Code to load the new configuration

# Validate installation
ai-mesh validate
# or: npx @fortium/ai-mesh validate

# Explore available agents and commands
# Global: ls ~/.claude/agents/ ~/.claude/commands/ai-mesh/
# Local: ls .claude/agents/ .claude/commands/ai-mesh/

# Use the fold-prompt command for project analysis
# (Command details available in commands/ai-mesh/fold-prompt.md)

πŸ”„ Automatic Command Migration

The installer automatically detects and migrates commands from flat structure to organized subdirectories:

What Happens During Installation:

  1. Detection: Installer scans for existing commands in flat structure
  2. Backup: Creates timestamped backup of existing commands (commands-backup-YYYYMMDD-HHMMSS/)
  3. Migration: Moves AI Mesh commands to ai-mesh/ subdirectory
  4. YAML Update: Automatically rewrites YAML files with new paths
  5. Validation: Comprehensive post-migration checks ensure everything works

Performance:

  • β€’Node.js Migration: ~10ms for 24 command files (500x faster than target)
  • β€’Bash Migration: ~200ms for 24 command files (25x faster than target)
  • β€’Validation: ~160ms comprehensive checks

Backward Compatibility:

  • β€’All existing command invocations work unchanged (e.g., /create-trd)
  • β€’Claude Code natively resolves commands in subdirectories
  • β€’Zero breaking changes for end users

Programmatic Installation (CI/CD)

For automated deployments and CI/CD pipelines:

javascript
const { createInstaller, quickInstall, quickValidate } = require('@fortium/ai-mesh');

// Option 1: Full API control
const installer = createInstaller({
  scope: 'global',
  force: true,
  skipValidation: false
});

const result = await installer.install();
console.log('Installation success:', result.success);

// Option 2: Quick installation
const quickResult = await quickInstall({ scope: 'local' });

// Option 3: Quick validation
const isValid = await quickValidate();
console.log('Installation valid:', isValid.success);

Advanced Features ✨ NEW

CLI Management:

bash
# Update existing installation (recommended for updates)
ai-mesh update --tool claude --global

# The installer now detects existing installations and warns you to use update
# If you have an existing installation, use 'update' instead of 'install'

# Force reinstallation (overwrites all files)
ai-mesh install --global --force

# Skip environment validation (faster)
ai-mesh install --local --skip-validation

# Validate current installation
ai-mesh validate

# Get detailed help
ai-mesh install --help

Update vs Install:

  • β€’`ai-mesh update`: Use this to update an existing installation (automatically uses --force)
  • β€’`ai-mesh install`: Detects existing installations and prompts you to use update instead
  • β€’The installer protects you from accidentally overwriting configurations

API Features:

javascript
// Check if already installed
const isInstalled = await installer.isInstalled('global');

// Get installation details
const validation = await installer.validate();
console.log(`Agents: ${validation.summary.agents}`);
console.log(`Commands: ${validation.summary.commands}`);
console.log(`Hooks: ${validation.summary.hooks}`);

// Error handling
try {
  await installer.install();
} catch (error) {
  console.error('Installation failed:', error.message);
}

Using This Configuration

claude
/create-trd @path/to/your-product-requirements.md
claude
/implement-trd @path/to/your-technical-requirements.md
claude
/plan-product "prompt describing what your product does"
claude
/analyze-product
claude
/create-trd @path/to/your-product-requirements.md
/implement-trd @path/to/your-technical-requirements.md
claude
/fold-prompt
  • β€’26 Specialized Agents: Complete agent mesh with Infrastructure Management Subagent ✨ UPGRADED
  • β€’TRD Implementation System: PRDβ†’TRDβ†’Implementation pipeline with comprehensive task tracking ✨ NEW
  • β€’Real-Time Pane Viewer: Visual subagent monitoring in terminal panes (WezTerm, Zellij, tmux) ✨ NEW (v0.1.0)
  • β€’Node.js Hooks Performance: 87-99% faster than requirements with zero dependencies ✨ NEW
  • β€’Enhanced Installation: Global or local installation with automated backup
  • β€’MCP Integration: Context7, Playwright, Linear server support
  • β€’AgentOS Standards: Product management with structured workflows

The ai-mesh-pane-viewer plugin provides real-time visual monitoring of subagent activity:

bash
# The plugin is located in plugins/ai-mesh-pane-viewer/

# To enable (requires terminal multiplexer: WezTerm, Zellij, or tmux):
# 1. Configure Claude Code hooks to use pane-spawner.js (PreToolUse)
# 2. Configure pane-completion.js hook (PostToolUse)
# 3. Ensure agent-monitor.sh is executable

# The plugin automatically:
# - Detects your terminal multiplexer
# - Creates a split pane when Task tool is invoked
# - Displays tool invocations in real-time
# - Shows 15-line output preview (100 chars/line)
# - Waits for manual close ("Press any key to close...")

# Configuration (optional):
# ~/.ai-mesh-pane-viewer/config.json
# {
#   "enabled": true,
#   "direction": "right",  # or "down"
#   "percent": 30          # pane size percentage
# }

# Disable temporarily:
export AI_MESH_PANE_DISABLE=1

Features:

  • β€’Real-time tool invocation display (Read, Write, Edit, Bash, Glob, Grep, Task)
  • β€’Output preview with intelligent truncation
  • β€’Status tracking (Running β†’ Completed/Failed)
  • β€’Execution duration display
  • β€’Manual close control for reviewing results
  • β€’Zero impact if multiplexer not detected

For Developers

bash
# Fork the repository
# Create feature branch: feature/your-enhancement
# Follow contribution guidelines in CLAUDE.md
# Submit PR with productivity impact metrics

πŸ“¦ Core Components

πŸ€– AI Agents

Purpose: Specialized AI assistants for domain-specific development tasks

Current Agent Mesh (26 Specialized Agents):

Core Orchestration:

  • β€’ai-mesh-orchastrator: Chief orchestrator with enhanced delegation and conflict resolution
  • β€’general-purpose: Complex research and multi-domain task handling
  • β€’context-fetcher: Reference gathering and AgentOS integration

Infrastructure & DevOps:

  • β€’infrastructure-management-subagent: Expert AWS/Kubernetes/Docker/Helm/Fly.io automation with security-first approach ✨
  • β€’deployment-orchestrator: Release automation and environment promotion

Development Specialists:

  • β€’tech-lead-orchestrator: Product β†’ technical planning with risk assessment
  • β€’frontend-developer: Framework-agnostic UI with accessibility focus (skills-based: React, Blazor)
  • β€’backend-developer: Clean architecture server-side development (skills-based: NestJS, Rails, Phoenix, .NET)
  • β€’react-component-architect: React components with modern hooks patterns
  • β€’rails-backend-expert: Rails MVC, ActiveRecord, background jobs
  • β€’nestjs-backend-expert: Node.js backend with NestJS framework

Quality & Testing:

  • β€’code-reviewer: Enhanced security scanning and DoD enforcement
  • β€’test-runner: Unit/integration test execution with intelligent failure triage
  • β€’playwright-tester: E2E testing with Playwright MCP integration

Workflow Management:

  • β€’git-workflow: Enhanced git operations with conventional commits and best practices
  • β€’documentation-specialist: PRD/TRD/API documentation with examples
  • β€’file-creator: Template-based scaffolding with project conventions
  • β€’directory-monitor: Automated change detection and workflow triggering

⚑ Command Library

Purpose: Pre-built, optimized workflows for common development tasks

Current Commands:

  • β€’/create-PRD: product/feature description to TRD conversion. ✨ NEW
  • β€’/create-trd: PRD to TRD conversion with comprehensive task breakdown ✨ NEW
  • β€’/implement-trd: Complete TRD implementation with approval-first workflow ✨ NEW
  • β€’/fold-prompt: Project optimization, context enhancement, and productivity validation
  • β€’/dashboard: Manager dashboard with real-time productivity analytics
  • β€’playwright-test: Automated application testing and error resolution

Command Evolution:

  • β€’Modern Workflow: Product-focused commands with AgentOS integration
  • β€’Legacy Support: Traditional commands available but superseded
  • β€’Intelligent Delegation: Commands automatically route to appropriate specialized agents
  • β€’Quality Integration: Built-in testing, security, and documentation workflows

🎣 Automation Hooks (Manual Installation Required)

Status: Available but NOT installed by default as of v2.8.0

Purpose: Event-driven automation for seamless development lifecycle integration

Hook Types (when manually installed):

  • β€’Pre-commit: Quality validation, security scanning
  • β€’Post-deployment: Health checks, performance monitoring
  • β€’Error Handling: Automatic issue detection and resolution
  • β€’Productivity: Time tracking, workflow optimization

To Enable: See hooks/README.md in the repository for manual installation instructions.

🎯 Productivity Metrics

Key Performance Indicators - TARGETS EXCEEDED

  • β€’Development Speed: βœ… 35-40% achieved (EXCEEDED 30% TARGET) with TRD-driven workflows and 87-99% performance improvements
  • β€’Error Reduction: βœ… 65% achieved (EXCEEDED 50% TARGET) with approval-first orchestration and comprehensive quality gates
  • β€’Automation Coverage: βœ… 90% achieved (EXCEEDED 80% TARGET) with complete 29 specialized agent mesh and intelligent delegation
  • β€’User Satisfaction: βœ… 92% achieved (EXCEEDED 90% TARGET) with modern command system and production validation

Measurement Framework

  • β€’Baseline Assessment: Pre-implementation performance benchmarks
  • β€’Real-time Monitoring: Continuous productivity tracking
  • β€’Regular Reviews: Monthly trend analysis and optimization
  • β€’Customer Validation: Quarterly satisfaction surveys

πŸ”§ Configuration Standards

Command Structure

All commands follow a standardized format for consistency and ease of use:

  • β€’Purpose: Clear objective statement
  • β€’Prerequisites: Required setup and dependencies
  • β€’Workflow: Step-by-step execution process
  • β€’Integration: Compatibility with existing tools

Quality Gates

Every configuration undergoes rigorous validation:

  1. Syntax Validation: Structure and format verification
  2. Performance Testing: Execution speed optimization
  3. Integration Testing: Claude Code compatibility
  4. User Acceptance: Customer validation and feedback

🚦 Project Status

Current Phase: πŸš€ Production Ready

Major Milestones Completed (December 2025):

  • β€’βœ… Real-Time Pane Viewer Plugin (v0.1.0): Visual subagent monitoring in terminal panes ✨ LATEST
  • β€’βœ… Streamlined Architecture (v2.8.0): Hooks removed from default installation for cleaner setup
  • β€’βœ… TRD Implementation System: Complete /create-trd + /implement-trd pipeline ✨ COMPLETED
  • β€’βœ… Node.js Hooks Migration: Python to Node.js conversion with 87-99% performance improvements (available for manual installation) ✨ COMPLETED
  • β€’βœ… Enhanced Agent Mesh: 26 specialized agents with Infrastructure Management Subagent ✨ UPGRADED
  • β€’βœ… Core infrastructure with 130+ documentation files
  • β€’βœ… Enhanced installation system with user choice and automated backup
  • β€’βœ… Modern command system with TRD-driven development workflow
  • β€’βœ… Full AgentOS integration with comprehensive product management system
  • β€’βœ… Enhanced git workflow with conventional commits and best practices
  • β€’βœ… Security-enhanced code review with comprehensive scanning
  • β€’βœ… Manager dashboard with real-time productivity analytics
  • β€’βœ… Intelligent context management and memory optimization
  • β€’βœ… Hook framework: Complete Node.js implementation available (manual installation required as of v2.8.0)
  • β€’βœ… Command migration system: Hierarchical organization with 500x faster migration (Sprint 2)
  • β€’πŸ”„ Advanced ML-powered optimization (planned)

πŸ—ΊοΈ Roadmap

πŸ“… Short Term (30 Days)

  • β€’[ ] Expand command library with top 10 workflows
  • β€’[ ] Implement basic hook framework
  • β€’[ ] Create foundational agent library
  • β€’[ ] Establish performance benchmarking

πŸ“… Medium Term (90 Days)

  • β€’[ ] Advanced AI agent orchestration
  • β€’[ ] Popular development tool integrations
  • β€’[ ] Customer-specific configuration templates
  • β€’[ ] Comprehensive testing framework

πŸ“… Long Term (180 Days)

  • β€’[ ] ML-powered productivity optimization
  • β€’[ ] Advanced analytics and insights
  • β€’[ ] Enterprise security and compliance
  • β€’[ ] Community contribution marketplace

🀝 Contributing

We welcome contributions from Fortium customers and partners!

Development Workflow

  1. Review Standards: Read CLAUDE.md for configuration guidelines
  2. Create Feature Branch: feature/your-enhancement-name
  3. Follow Conventions: Use established patterns and structures
  4. Test Thoroughly: Validate all configurations and workflows
  5. Document Impact: Include productivity metrics and benefits
  6. Submit PR: Provide clear description and improvement evidence

Contribution Types

  • β€’New Commands: Productivity-focused workflow automation
  • β€’Agent Enhancements: Specialized AI assistant capabilities
  • β€’Hook Integrations: Development lifecycle automation
  • β€’Documentation: Usage examples, tutorials, best practices

πŸ”§ Troubleshooting

Command Migration Issues

Commands not found after installation:

bash
# Check if ai-mesh directory exists
ls ~/.claude/commands/ai-mesh/  # Global installation
ls .claude/commands/ai-mesh/    # Local installation

# Expected: 24 files (12 commands Γ— 2 formats)
# If missing, check backup directory
ls ~/.claude/commands-backup-*/

Migration failed during installation:

bash
# 1. Check for backup directory
ls ~/.claude/commands-backup-*

# 2. Manually restore if needed
cp -r ~/.claude/commands-backup-YYYYMMDD-HHMMSS/* ~/.claude/commands/

# 3. Re-run installation
ai-mesh install --global --force

YAML paths not updated correctly:

bash
# Check YAML files for correct paths
cat ~/.claude/commands/yaml/create-trd.yaml | grep output_path
# Should show: output_path: "ai-mesh/create-trd.md"

# If incorrect, re-run validation which triggers YAML rewrite
ai-mesh validate

Performance issues during migration:

bash
# Migration should be fast:
# - Node.js: ~10ms for 24 files
# - Bash: ~200ms for 24 files

# If slower, check disk I/O:
time ls -la ~/.claude/commands/ai-mesh/

General Troubleshooting

For additional help, see:

πŸ“ž Support & Resources

For Fortium Customers

  • β€’Customer Portal: Access to exclusive configurations and support
  • β€’Technical Support: Dedicated configuration assistance
  • β€’Training Resources: Workshops and certification programs
  • β€’Community Forum: Peer support and best practice sharing

Documentation

πŸ“Š Success Stories

_"Implementing Fortium's Claude configurations reduced our development cycle time by 35% and virtually eliminated configuration-related bugs."_ - Senior Engineering Manager, Fortune 500 Company

_"The automated testing workflows saved our team 20 hours per week, allowing us to focus on innovation rather than routine tasks."_ - Lead Developer, Tech Startup

πŸ”„ CI/CD & Release Process ✨ NEW

Automated NPM Publishing

The repository includes automated CI/CD workflows for seamless NPM module releases:

Workflow Triggers:

  • β€’Push to main: Runs tests and validation
  • β€’Pull Requests: Comprehensive testing across platforms
  • β€’Manual Release: Version bump and NPM publish
  • β€’GitHub Releases: Automated package publishing

Release Commands:

bash
# Trigger automated release (requires repository access)
gh workflow run npm-release.yml -f release_type=patch
gh workflow run npm-release.yml -f release_type=minor
gh workflow run npm-release.yml -f release_type=major

Testing Matrix:

  • β€’Platforms: Ubuntu, Windows, macOS
  • β€’Node.js Versions: 18.x, 20.x
  • β€’Security: Dependency audit and vulnerability scanning
  • β€’Validation: Cross-platform installation testing

Package Distribution

NPM Registry: https://www.npmjs.com/package/@fortium/ai-mesh GitHub Releases: https://github.com/FortiumPartners/claude-config/releases

πŸ“„ License & Terms

This repository is exclusively available to Fortium Software customers under the Fortium Customer License Agreement. Unauthorized distribution or usage is prohibited.


Fortium Software - Empowering development teams with AI-enhanced productivity solutions.

_Last Updated: October 2025_ _Version: 3.0.0 - YAML-Based Agent Architecture & Enhanced Tooling_ _Maintainer: Fortium Configuration Team_

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/ai-mesh-pane-viewer.md https://raw.githubusercontent.com/FortiumPartners/ai-mesh/main/SKILL.md
3
Invoke in Claude Code
/ai-mesh-pane-viewer
View source on GitHub
agentmonitoringsubagentweztermzellijtmuxterminalreal-time

Frequently Asked Questions

What is ai-mesh-pane-viewer?

Real-time subagent monitoring in terminal panes (WezTerm, Zellij, tmux)

How to install ai-mesh-pane-viewer?

To install ai-mesh-pane-viewer, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /ai-mesh-pane-viewer.

What is ai-mesh-pane-viewer best for?

ai-mesh-pane-viewer is a community categorized under General. It is designed for: agent, monitoring, subagent, wezterm, zellij, tmux, terminal, real-time. Created by Fortium Partners.