mcp-ticketer 0.1.22__tar.gz → 0.1.24__tar.gz

{mcp_ticketer-0.1.22 → mcp_ticketer-0.1.24}/.claude/agents/.dependency_cache

@@ -30,5 +30,21 @@
     },
     "deployment_hash": "c460ffb1ea5088ce8ee0e1d6e3e83d434833608e29ac2e64fd4d4d8f16f54c17",
     "context": {}
+  },
+  "a6ed1f2f77fa5685d99bd273841ad27f": {
+    "timestamp": 1761231666.407605,
+    "results": {
+      "agents": {},
+      "summary": {
+        "total_agents": 36,
+        "agents_with_deps": 0,
+        "missing_python": [],
+        "missing_system": [],
+        "satisfied_python": [],
+        "satisfied_system": []
+      }
+    },
+    "deployment_hash": "7f28a565c16fcf25761e1d1fb603bc06a4fa5f079542c081b9b2b025b54b2a8e",
+    "context": {}
   }
 }

{mcp_ticketer-0.1.22 → mcp_ticketer-0.1.24}/.claude/agents/.mpm_deployment_state

@@ -1,6 +1,6 @@
 {
-  "deployment_hash": "c460ffb1ea5088ce8ee0e1d6e3e83d434833608e29ac2e64fd4d4d8f16f54c17",
-  "last_check_time": 1761160971.8831968,
+  "deployment_hash": "7f28a565c16fcf25761e1d1fb603bc06a4fa5f079542c081b9b2b025b54b2a8e",
+  "last_check_time": 1761231666.407993,
   "last_check_results": {
     "agents": {},
     "summary": {

{mcp_ticketer-0.1.22 → mcp_ticketer-0.1.24}/.claude/agents/local_ops_agent.md

@@ -3,7 +3,7 @@ name: local-ops-agent
 description: "Use this agent when you need specialized assistance with specialized agent for managing local development deployments with focus on maintaining single stable instances, protecting existing services, and never interfering with other projects or claude code services. This agent provides targeted expertise and follows best practices for local_ops_agent related tasks.\n\n<example>\nContext: When you need specialized assistance from the local_ops_agent agent.\nuser: \"I need help with local_ops_agent tasks\"\nassistant: \"I'll use the local_ops_agent agent to provide specialized assistance.\"\n<commentary>\nThis agent provides targeted expertise for local_ops_agent related tasks and follows established best practices.\n</commentary>\n</example>"
 model: sonnet
 category: operations
-version: "1.0.2"
+version: "2.0.0"
 tags: deployment,devops,local,process-management,monitoring
 ---
 # Agent Instructions

mcp_ticketer-0.1.24/.mcp/config.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "mcp-ticketer": {
+      "command": "/Users/masa/.local/bin/mcp-ticketer",
+      "args": [
+        "serve"
+      ],
+      "cwd": "/Users/masa/Projects/mcp-ticketer"
+    }
+  }
+}

{mcp_ticketer-0.1.22 → mcp_ticketer-0.1.24}/CHANGELOG.md

@@ -15,6 +15,42 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Analytics dashboard
 - Webhook notification support
 
+## [0.1.24] - 2025-10-24
+
+### Added
+- **Multi-Client MCP Support**: Added support for 4 AI clients
+  - Claude Code integration with project and global config (`mcp-ticketer mcp claude`)
+  - Gemini CLI integration with project/user scope (`mcp-ticketer mcp gemini`)
+  - Codex CLI integration with global TOML config (`mcp-ticketer mcp codex`)
+  - Auggie CLI integration with global JSON config (`mcp-ticketer mcp auggie`)
+- **Nested Command Structure**: New `mcp` command group with 4 client-specific subcommands
+- **Configuration Modules**: Three new CLI configuration modules
+  - `auggie_configure.py` - Auggie CLI configuration handler
+  - `codex_configure.py` - Codex CLI TOML configuration handler
+  - `gemini_configure.py` - Gemini CLI JSON configuration handler
+- **TOML Support**: Added `tomli` and `tomli-w` dependencies for Codex CLI TOML config
+- **Comprehensive Documentation**:
+  - AI Client Integration Guide (docs/AI_CLIENT_INTEGRATION.md, 937 lines)
+  - Codex Integration Guide (CODEX_INTEGRATION.md, 312 lines)
+  - Updated CLAUDE.md with 800+ lines of multi-client documentation
+  - Updated README.md with AI client comparison table
+  - Updated QUICK_START.md with client selection decision tree
+
+### Changed
+- **Command Structure**: Renamed MCP commands to nested structure under `mcp` parent command
+  - `mcp-ticketer mcp` → `mcp-ticketer mcp claude`
+  - `mcp-ticketer gemini` → `mcp-ticketer mcp gemini`
+  - `mcp-ticketer codex` → `mcp-ticketer mcp codex`
+  - `mcp-ticketer auggie` → `mcp-ticketer mcp auggie`
+- **Documentation Version**: Updated CLAUDE.md from 0.1.11 to 0.1.24
+- **Type Hints**: Modernized type hints in JIRA and Linear adapters
+- **gitignore**: Added `.gemini/` directory exclusion
+
+### Fixed
+- Removed obsolete MCP server startup error documentation
+- Improved configuration file handling for multiple AI clients
+- Enhanced MCP server path detection and validation
+
 ## [0.1.10] - 2025-09-29
 
 ### Fixed

{mcp_ticketer-0.1.22 → mcp_ticketer-0.1.24}/CLAUDE.md

@@ -1,9 +1,9 @@
 # CLAUDE.md - MCP Ticketer AI Agent Instructions
 
-**Version**: 0.1.11
-**Last Updated**: 2025-10-22
+**Version**: 0.1.24
+**Last Updated**: 2025-10-24
 **Project**: MCP Ticketer - Universal Ticket Management Interface for AI Agents
-**Optimized For**: Claude Code, Claude MPM, and AI Agent Collaboration
+**Optimized For**: Claude Code, Gemini CLI, Codex CLI, Auggie, and AI Agent Collaboration
 
 ---
 
@@ -800,9 +800,45 @@ mcp-ticketer --help       # Show CLI help
 
 ---
 
-## ⚪ OPTIONAL: AI Agent Integration
+## ⚪ OPTIONAL: AI Client Integration
 
-### Claude Code Integration
+### Overview: Multiple AI Client Support
+
+**MCP Ticketer supports 4 major AI clients with MCP integration:**
+
+| Client | Project-Level | Config Format | Config Location | Command |
+|--------|---------------|---------------|-----------------|---------|
+| **Claude Code** | ✅ Yes | JSON | `.claude/mcp.json` | `mcp-ticketer mcp claude` |
+| **Gemini CLI** | ✅ Yes | JSON | `.gemini/settings.json` | `mcp-ticketer mcp gemini` |
+| **Codex CLI** | ❌ No (Global only) | TOML | `~/.codex/config.toml` | `mcp-ticketer mcp codex` |
+| **Auggie** | ❌ No (Global only) | JSON | `~/.augment/settings.json` | `mcp-ticketer mcp auggie` |
+
+**Quick Setup:**
+```bash
+# Claude Code (project-level, recommended)
+mcp-ticketer mcp claude
+
+# Gemini CLI (project-level)
+mcp-ticketer mcp gemini --scope project
+
+# Codex CLI (global-only, restart required)
+mcp-ticketer mcp codex
+
+# Auggie (global-only)
+mcp-ticketer mcp auggie
+```
+
+**When to use which client:**
+- **Claude Code**: Best for project-specific workflows, native MCP support
+- **Gemini CLI**: Google's AI client, supports project-level configuration
+- **Codex CLI**: Global configuration only, requires restart after config changes
+- **Auggie**: Simple global setup, suitable for single-project users
+
+**See Also:** [AI Client Integration Guide](docs/AI_CLIENT_INTEGRATION.md) for comprehensive setup instructions.
+
+---
+
+### Claude Code Integration (Recommended)
 
 **MCP Ticketer is optimized for Claude Code workflows:**
 
@@ -811,13 +847,31 @@ mcp-ticketer --help       # Show CLI help
 make install-dev
 make init-aitrackdown
 
-# 2. Enable MCP server for Claude Desktop
-# Add to Claude Desktop config:
+# 2. Configure MCP integration (THE ONLY WAY)
+mcp-ticketer mcp claude
+
+# Alternative: Configure for Claude Desktop (global)
+mcp-ticketer mcp claude --global
+
+# 3. Configuration created at:
+# Project-level: .claude/mcp.json
+# Global: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
+#         %APPDATA%/Claude/claude_desktop_config.json (Windows)
+#         ~/.config/Claude/claude_desktop_config.json (Linux)
+
+# 4. Use via Claude Code
+# Claude can now create, read, update tickets directly
+# Example: "Create a high-priority task for fixing the login bug"
+```
+
+**Example Configuration (.claude/mcp.json):**
+```json
 {
   "mcpServers": {
-    "ticketer": {
-      "command": "mcp-ticketer-server",
-      "args": [],
+    "mcp-ticketer": {
+      "command": "/path/to/mcp-ticketer",
+      "args": ["serve"],
+      "cwd": "/Users/masa/Projects/mcp-ticketer",
       "env": {
         "MCP_TICKETER_ADAPTER": "aitrackdown",
         "MCP_TICKETER_BASE_PATH": "/Users/masa/Projects/mcp-ticketer/.aitrackdown"
@@ -825,12 +879,181 @@ make init-aitrackdown
     }
   }
 }
+```
 
-# 3. Use via Claude Code
-# Claude can now create, read, update tickets directly
-# Example: "Create a high-priority task for fixing the login bug"
+---
+
+### Gemini CLI Integration
+
+**Google's Gemini CLI with project-level MCP support:**
+
+```bash
+# 1. Initialize mcp-ticketer
+make install-dev
+make init-aitrackdown
+
+# 2. Configure for Gemini CLI (THE ONLY WAY)
+mcp-ticketer mcp gemini --scope project
+
+# Alternative: Global configuration
+mcp-ticketer mcp gemini --scope user
+
+# 3. Configuration created at:
+# Project-level: .gemini/settings.json (added to .gitignore automatically)
+# User-level: ~/.gemini/settings.json
+
+# 4. Use with Gemini CLI
+# Run gemini command in project directory
+# MCP tools automatically available
+```
+
+**Example Configuration (.gemini/settings.json):**
+```json
+{
+  "mcpServers": {
+    "mcp-ticketer": {
+      "command": "/path/to/mcp-ticketer",
+      "args": ["serve"],
+      "env": {
+        "PYTHONPATH": "/path/to/project/src",
+        "MCP_TICKETER_ADAPTER": "aitrackdown",
+        "MCP_TICKETER_BASE_PATH": "/path/to/project/.aitrackdown"
+      },
+      "timeout": 15000,
+      "trust": false
+    }
+  }
+}
+```
+
+**Features:**
+- ✅ Project-level configuration support
+- ✅ JSON configuration format (familiar)
+- ✅ Automatic .gitignore management
+- ✅ 15-second timeout for MCP operations
+- ✅ Security: untrusted by default
+
+---
+
+### Codex CLI Integration
+
+**⚠️ IMPORTANT: Codex CLI only supports GLOBAL configuration**
+
+```bash
+# 1. Initialize mcp-ticketer
+make install-dev
+make init-aitrackdown
+
+# 2. Configure for Codex CLI (THE ONLY WAY)
+mcp-ticketer mcp codex
+
+# 3. Configuration created at:
+# Global only: ~/.codex/config.toml
+
+# 4. RESTART Codex CLI (REQUIRED)
+# Codex does not hot-reload configuration
+
+# 5. Use with Codex CLI
+# Run codex command in any directory
+# MCP tools will be available globally
+```
+
+**Example Configuration (~/.codex/config.toml):**
+```toml
+[mcp_servers.mcp-ticketer]
+command = "/path/to/mcp-ticketer"
+args = ["serve"]
+
+[mcp_servers.mcp-ticketer.env]
+PYTHONPATH = "/path/to/project/src"
+MCP_TICKETER_ADAPTER = "aitrackdown"
+MCP_TICKETER_BASE_PATH = "/path/to/project/.aitrackdown"
 ```
 
+**Limitations:**
+- ❌ No project-level configuration support
+- ❌ Global configuration affects all projects
+- ⚠️ Requires restart after configuration changes
+- ⚠️ TOML format (different from other clients)
+
+**Use when:**
+- You primarily work on one project
+- You need global MCP access across all directories
+- You prefer TOML configuration
+
+---
+
+### Auggie Integration
+
+**⚠️ IMPORTANT: Auggie only supports GLOBAL configuration**
+
+```bash
+# 1. Initialize mcp-ticketer
+make install-dev
+make init-aitrackdown
+
+# 2. Configure for Auggie (THE ONLY WAY)
+mcp-ticketer mcp auggie
+
+# 3. Configuration created at:
+# Global only: ~/.augment/settings.json
+
+# 4. Restart Auggie CLI
+# Auggie should pick up the new configuration
+
+# 5. Use with Auggie CLI
+# Run auggie command in any directory
+# MCP tools will be available globally
+```
+
+**Example Configuration (~/.augment/settings.json):**
+```json
+{
+  "mcpServers": {
+    "mcp-ticketer": {
+      "command": "/path/to/mcp-ticketer",
+      "args": ["serve"],
+      "env": {
+        "MCP_TICKETER_ADAPTER": "aitrackdown",
+        "MCP_TICKETER_BASE_PATH": "/Users/user/.mcp-ticketer/.aitrackdown"
+      }
+    }
+  }
+}
+```
+
+**Limitations:**
+- ❌ No project-level configuration support
+- ❌ Global configuration affects all projects
+- ⚠️ Uses global paths for adapter storage
+
+**Use when:**
+- You work on a single project primarily
+- You want simple, global MCP access
+- You prefer JSON configuration
+
+---
+
+### Comparison: Which Client Should You Use?
+
+| Feature | Claude Code | Gemini CLI | Codex CLI | Auggie |
+|---------|-------------|------------|-----------|--------|
+| **Project-level config** | ✅ Yes | ✅ Yes | ❌ No | ❌ No |
+| **Global config** | ✅ Yes | ✅ Yes | ✅ Only option | ✅ Only option |
+| **Config format** | JSON | JSON | TOML | JSON |
+| **Hot reload** | ✅ Yes | ✅ Yes | ❌ Requires restart | ⚠️ May require restart |
+| **Security options** | ⚠️ Basic | ✅ Trust setting | ⚠️ Basic | ⚠️ Basic |
+| **Working directory** | ✅ Supported | ✅ Supported | ⚠️ Global only | ⚠️ Global only |
+| **Auto .gitignore** | ⚠️ Manual | ✅ Automatic | N/A | N/A |
+| **Maturity** | ✅ Stable | ✅ Stable | ⚠️ Beta | ⚠️ Emerging |
+
+**Recommendation:**
+- **Best choice**: Claude Code (native integration, project-level support)
+- **Alternative**: Gemini CLI (excellent project-level support, security features)
+- **Single project**: Codex CLI or Auggie (simple global setup)
+
+---
+
 ### Agent Collaboration Patterns
 
 **Multi-Agent Workflow:**

{mcp_ticketer-0.1.22 → mcp_ticketer-0.1.24}/CLAUDE_DESKTOP_SETUP.md

@@ -37,7 +37,7 @@ The configuration file at `~/.mcp-ticketer/config.json` controls which adapter i
 
 Test the MCP server:
 ```bash
-echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | /Users/masa/.local/bin/mcp-ticketer mcp
+echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | /Users/masa/.local/bin/mcp-ticketer serve
 ```
 
 You should see a JSON response with the server information.
@@ -46,7 +46,7 @@ You should see a JSON response with the server information.
 
 For development, use the `mcp_server.sh` script in the project directory:
 ```bash
-./mcp_server.sh mcp
+./mcp_server.sh serve
 ```
 
 This script: