Interactive Mode
Interactive mode provides a terminal-based visual interface for browsing and installing components. It’s perfect when you don’t know exactly which components you need or want to explore what’s available.Launching Interactive Mode
Run the CLI without any flags:Main Menu
The main menu offers several options:Menu Options Explained
Menu Options Explained
Project Setup Flow
Selecting “Project Setup” starts the component selection wizard.⠋ Detecting project type...
✔ Project detection complete
Target directory: /Users/you/projects/my-app
package.json, requirements.txt, etc.)? Select a template for your project:
❯ common - Universal Claude Code setup for any language
javascript-typescript - Node.js, TypeScript, React, Vue
python - Python, Django, Flask, FastAPI
ruby - Ruby, Rails
java - Java, Spring, Maven, Gradle
go - Go, Gin, Echo
rust - Rust, Cargo
Template Recommendation: If your language is detected, it will be pre-selected. You can change it if needed.
? Select agents to install (Space to select, Enter to continue):
Development Team
◯ frontend-developer - React, Vue, Angular specialist
◉ backend-developer - Node.js, Python, API development
◯ full-stack-developer - End-to-end web development
Security
◉ security-auditor - Security analysis and vulnerability detection
◯ penetration-tester - Security testing and exploitation
Data/AI
◯ ml-engineer - Machine learning model development
◯ data-scientist - Data analysis and visualization
? Select commands to install:
Development
◉ docker-setup - Docker and docker-compose configuration
◉ setup-testing - Jest, Pytest, or other test frameworks
◯ git-setup - Git configuration and hooks
DevOps
◯ ci-pipeline - GitHub Actions, GitLab CI setup
◯ deploy-vercel - Vercel deployment configuration
? Select MCP servers to install:
◉ filesystem - File system access for Claude
◉ web-fetch - HTTP requests and web scraping
◯ database - PostgreSQL/MySQL integration
◯ github-integration - GitHub API access
MCP Dependencies: Some MCPs require additional setup (API keys, etc.). Check the documentation after installation.
? Select automation hooks to install:
Git Workflow
◉ git/pre-commit-lint - Run linting before git commit
◯ git/prevent-force-push - Block git push --force
Automation
◉ automation/simple-notifications - Desktop notifications
◯ automation/build-on-change - Auto-build on file save
? Select settings to configure:
◉ enable-telemetry - Share usage data to improve Claude Code
◯ use-sonnet - Use Claude Sonnet model (faster)
◯ use-opus - Use Claude Opus model (more powerful)
◯ read-only-mode - Prevent file modifications
? Where would you like to install settings and hooks?
◯ User settings (~/.claude/settings.json) - All projects
◯ Project settings (.claude/settings.json) - This project, shared with team
◉ Local settings (.claude/settings.local.json) - This project, personal only
📋 Installation Summary:
Agents (2):
• backend-developer
• security-auditor
Commands (2):
• docker-setup
• setup-testing
MCPs (2):
• filesystem
• web-fetch
Hooks (2):
• git/pre-commit-lint
• automation/simple-notifications
Settings (1):
• enable-telemetry
? Proceed with installation? (Y/n)
⠋ Copying template files...
✔ Template files copied successfully
🤖 Installing Claude Code agents...
✅ Agent "backend-developer" installed successfully!
✅ Agent "security-auditor" installed successfully!
⚡ Installing commands...
✅ Command "docker-setup" installed successfully!
✅ Command "setup-testing" installed successfully!
🔌 Installing MCPs...
✅ MCP "filesystem" installed successfully!
✅ MCP "web-fetch" installed successfully!
🪝 Installing hooks...
✅ Hook "git/pre-commit-lint" installed successfully!
✅ Hook "automation/simple-notifications" installed successfully!
⚙️ Configuring settings...
✅ Setting "enable-telemetry" installed successfully!
✅ Claude Code configuration setup complete!
📚 Next steps:
1. Review the generated CLAUDE.md file
2. Customize the configuration for your project
3. Start using Claude Code with: claude
🌐 View all available templates at: https://aitmpl.com/
📖 Read the complete documentation at: https://docs.aitmpl.com/
💡 Language-specific features for javascript-typescript have been configured
🎯 Framework-specific commands for react are available
🔧 4 automation hooks have been configured
🔧 2 MCP servers have been configured
Interactive Features
Back Navigation
You can go back to previous steps using Ctrl+C and restarting, or by using the back option in some prompts.Search and Filter
When selecting components, you can filter by typing:Select All / Deselect All
Some prompts support bulk selection:- Ctrl+A - Select all visible items
- Ctrl+D - Deselect all items
Component Details
Some interactive prompts show component descriptions when you hover over them.Health Check Mode
Selecting “Health Check” from the main menu:🔍 Running Health Check...
✔ Claude CLI detected
✔ Project directory accessible
✔ .claude directory exists
⚠ No agents installed
⚠ No commands installed
✔ .mcp.json configured correctly
⚠ No hooks configured
📋 Health Check Results:
✅ Passed: 3/6 checks
⚠️ Warnings: 3/6 checks
❌ Errors: 0/6 checks
💡 Recommendations:
• Install at least one agent for task automation
• Consider adding development commands
• Configure automation hooks for better workflow
? Would you like to run Project Setup now? (Y/n)
Analytics Dashboard
Selecting “Analytics Dashboard” opens a web interface:- Session history and duration
- Component usage statistics
- Download counts for your installed components
- Trending components in the community
- Agent conversation analytics
Tunnel Mode: Add
--tunnel flag to expose the dashboard publicly via Cloudflare:Chats Mobile Interface
Selecting “Chats Mobile” launches a mobile-optimized chat interface:- Touch interactions
- Small screens
- Conversation history
- Quick component installation
Non-Interactive Equivalent
Every interactive selection can be replicated with CLI flags:Customizing Interactive Mode
Pre-select Components
You can start interactive mode with some components already specified:Skip Specific Prompts
Use--yes to skip confirmation prompts:
Target Directory
Specify directory before launching interactive mode:Keyboard Shortcuts Reference
| Shortcut | Action |
|---|---|
| Arrow Up/Down | Navigate options |
| Space | Toggle selection (checkboxes) |
| Enter | Confirm and continue |
| Ctrl+C | Cancel and exit |
| Ctrl+A | Select all (where supported) |
| Ctrl+D | Deselect all (where supported) |
| Backspace | Clear filter text |
| Tab | Auto-complete (in some prompts) |
Troubleshooting Interactive Mode
Terminal Display Issues
If the interface looks broken:Arrow Keys Not Working
Some terminals (especially in Docker) don’t support interactive prompts: Solution: Use non-interactive mode with flags instead:Session Timeout
If you wait too long on a prompt:--yes flag.
Component List Not Loading
If components don’t appear:Best Practices
First-Time Users
- Run Health Check First: Understand your current setup
- Start with Recommended: Let the CLI suggest components based on your project
- Install Incrementally: Don’t install everything at once—add components as you need them
Team Onboarding
- Generate Command: One person runs interactive mode
- Copy Non-Interactive Command: Share the equivalent CLI command with team
- Document in README: Add the command to project documentation
Exploring Components
Use interactive mode to discover components, then:- Note which components you selected
- Visit aitmpl.com to read full documentation
- Create a saved workflow for future projects
Next Steps
Batch Installation
Install multiple components at once
Workflows
Save your selection as a reusable workflow
Global Agents
Create agents accessible from anywhere
Component Browser
Browse all available components