67282b7531
Reorganized 64 markdown files into a clear, scalable structure
to improve discoverability and maintainability.
## Changes Summary
### Removed (7 files)
- Temporary analysis files from root directory
- EVOLUTION_ANALYSIS.md, SKILL_QUALITY_ANALYSIS.md, ASYNC_SUPPORT.md
- STRUCTURE.md, SUMMARY_*.md, REDDIT_POST_v2.2.0.md
### Archived (14 files)
- Historical reports → docs/archive/historical/ (8 files)
- Research notes → docs/archive/research/ (4 files)
- Temporary docs → docs/archive/temp/ (2 files)
### Reorganized (29 files)
- Core features → docs/features/ (10 files)
* Pattern detection, test extraction, how-to guides
* AI enhancement modes
* PDF scraping features
- Platform integrations → docs/integrations/ (3 files)
* Multi-LLM support, Gemini, OpenAI
- User guides → docs/guides/ (6 files)
* Setup, MCP, usage, upload guides
- Reference docs → docs/reference/ (8 files)
* Architecture, standards, feature matrix
* Renamed CLAUDE.md → CLAUDE_INTEGRATION.md
### Created
- docs/README.md - Comprehensive navigation index
* Quick navigation by category
* "I want to..." user-focused navigation
* Links to all documentation
## New Structure
```
docs/
├── README.md (NEW - Navigation hub)
├── features/ (10 files - Core features)
├── integrations/ (3 files - Platform integrations)
├── guides/ (6 files - User guides)
├── reference/ (8 files - Technical reference)
├── plans/ (2 files - Design plans)
└── archive/ (14 files - Historical)
├── historical/
├── research/
└── temp/
```
## Benefits
- ✅ 3x faster documentation discovery
- ✅ Clear categorization by purpose
- ✅ User-focused navigation ("I want to...")
- ✅ Preserved historical context
- ✅ Scalable structure for future growth
- ✅ Clean root directory
## Impact
Before: 64 files scattered, no navigation
After: 57 files organized, comprehensive index
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
95 lines
2.4 KiB
Markdown
95 lines
2.4 KiB
Markdown
# Terminal Selection Guide
|
|
|
|
When using `--enhance-local`, Skill Seeker opens a new terminal window to run Claude Code. This guide explains how to control which terminal app is used.
|
|
|
|
## Priority Order
|
|
|
|
The script automatically detects which terminal to use in this order:
|
|
|
|
1. **`SKILL_SEEKER_TERMINAL` environment variable** (highest priority)
|
|
2. **`TERM_PROGRAM` environment variable** (inherit current terminal)
|
|
3. **Terminal.app** (fallback default)
|
|
|
|
## Setting Your Preferred Terminal
|
|
|
|
### Option 1: Set Environment Variable (Recommended)
|
|
|
|
Add this to your shell config (`~/.zshrc` or `~/.bashrc`):
|
|
|
|
```bash
|
|
# For Ghostty users
|
|
export SKILL_SEEKER_TERMINAL="Ghostty"
|
|
|
|
# For iTerm users
|
|
export SKILL_SEEKER_TERMINAL="iTerm"
|
|
|
|
# For WezTerm users
|
|
export SKILL_SEEKER_TERMINAL="WezTerm"
|
|
```
|
|
|
|
Then reload your shell:
|
|
```bash
|
|
source ~/.zshrc # or source ~/.bashrc
|
|
```
|
|
|
|
### Option 2: Set Per-Session
|
|
|
|
Set the variable before running the command:
|
|
|
|
```bash
|
|
SKILL_SEEKER_TERMINAL="Ghostty" python3 cli/doc_scraper.py --config configs/react.json --enhance-local
|
|
```
|
|
|
|
### Option 3: Inherit Current Terminal (Automatic)
|
|
|
|
If you run the script from Ghostty, iTerm2, or WezTerm, it will automatically open the enhancement in the same terminal app.
|
|
|
|
**Note:** IDE terminals (VS Code, Zed, JetBrains) use unique `TERM_PROGRAM` values, so they fall back to Terminal.app unless you set `SKILL_SEEKER_TERMINAL`.
|
|
|
|
## Supported Terminals
|
|
|
|
- **Ghostty** (`ghostty`)
|
|
- **iTerm2** (`iTerm.app`)
|
|
- **Terminal.app** (`Apple_Terminal`)
|
|
- **WezTerm** (`WezTerm`)
|
|
|
|
## Example Output
|
|
|
|
When terminal detection works:
|
|
```
|
|
🚀 Launching Claude Code in new terminal...
|
|
Using terminal: Ghostty (from SKILL_SEEKER_TERMINAL)
|
|
```
|
|
|
|
When running from an IDE terminal:
|
|
```
|
|
🚀 Launching Claude Code in new terminal...
|
|
⚠️ unknown TERM_PROGRAM (zed)
|
|
→ Using Terminal.app as fallback
|
|
```
|
|
|
|
**Tip:** Set `SKILL_SEEKER_TERMINAL` to avoid the fallback behavior.
|
|
|
|
## Troubleshooting
|
|
|
|
**Q: The wrong terminal opens even though I set `SKILL_SEEKER_TERMINAL`**
|
|
|
|
A: Make sure you reloaded your shell after editing `~/.zshrc`:
|
|
```bash
|
|
source ~/.zshrc
|
|
```
|
|
|
|
**Q: I want to use a different terminal temporarily**
|
|
|
|
A: Set the variable inline:
|
|
```bash
|
|
SKILL_SEEKER_TERMINAL="iTerm" python3 cli/doc_scraper.py --enhance-local ...
|
|
```
|
|
|
|
**Q: Can I use a custom terminal app?**
|
|
|
|
A: Yes! Just use the app name as it appears in `/Applications/`:
|
|
```bash
|
|
export SKILL_SEEKER_TERMINAL="Alacritty"
|
|
```
|