Repository navigation
v0.1.0 - First Production Release π
aiterm v0.1.0 - Terminal Optimizer for AI Development
First production release! π
β¨ What's New
Core Features
- π― Smart Context Detection - Automatically detects 8 project types
- π¨ Auto Profile Switching - iTerm2 colors change based on project
- βοΈ Claude Code Integration - Manage settings and auto-approvals
- π¦ 8 Auto-Approval Presets - Safe, curated permission sets
- β‘ UV-Optimized - 10-100x faster installation than pip
- π§ͺ Well-Tested - 51 tests, 83% coverage
π¦ Installation
Recommended: UV (Fastest!)
```bash
Install UV if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh
Install aiterm
uv tool install git+https://github.com/Data-Wise/aiterm
```
Alternative: pipx
```bash
pipx install git+https://github.com/Data-Wise/aiterm
```
Verify Installation
```bash
aiterm --version
aiterm doctor
```
π― Quick Start
```bash
Detect current project context
ait detect
Apply context to iTerm2
ait switch
View Claude Code settings
ait claude settings
Add safe auto-approvals
ait claude approvals add safe-reads
ait claude approvals add git-ops
```
π Documentation
Complete documentation: https://data-wise.github.io/aiterm/
π¨ Context Types
| Context | Icon | Profile | Triggered By |
|---|---|---|---|
| Production | π¨ | Red theme | */production/* path |
| AI Sessions | π€ | Purple theme | */claude-sessions/* |
| R Packages | π¦ | Blue theme | DESCRIPTION file |
| Python | π | Green theme | pyproject.toml |
| Node.js | π¦ | Dark theme | package.json |
| Quarto | π | Blue theme | _quarto.yml |
| Emacs | π§ | Dev-Tools | .spacemacs |
| Dev Tools | π οΈ | Dev-Tools | .git + scripts/ |
π οΈ Auto-Approval Presets
- safe-reads - Read-only operations
- git-ops - Git commands (status, diff, log, commit, push)
- github-cli - GitHub CLI operations
- python-dev - Python tools (pytest, pip, uv)
- node-dev - Node.js tools (npm, npx, bun)
- r-dev - R development (Rscript, quarto)
- web-tools - Web search and fetch
- minimal - Basic shell commands only
π‘ Use Cases
For Claude Code Users
```bash
Set up safe auto-approvals
ait claude approvals add safe-reads
ait claude approvals add git-ops
ait claude approvals add python-dev
```
For Multi-Project Developers
```bash
cd ~/projects/webapp/
ait switch # β Node-Dev profile (green)
cd ~/production/live-site/
ait switch # β Production profile (RED!) π¨
```
For R Package Developers
```bash
cd ~/r-packages/mypackage/
ait detect # Shows: π¦ r-package β R-Dev profile
ait switch # Applies R-optimized colors
```
π― What's Next?
v0.2.0 (Coming Soon)
- Hook management system
- MCP server integration
- StatusLine builder
- Multi-terminal support
π Stats
- Tests: 51 passing, 83% coverage
- Documentation: 2,647 lines
- Installation: < 2 minutes with UV
- Performance: < 100ms for all operations
π Acknowledgments
Built for AI-assisted development workflows with:
- Claude Code - Anthropic's CLI
- iTerm2 - macOS terminal
- UV - Fast Python packaging
Full Changelog: See CHANGELOG.md