Claude Code Integration

Overview

AirTower works alongside Claude Code by monitoring the same files that Claude reads and writes. When Claude runs tests or builds via wrapper scripts, AirTower picks up the results automatically and displays them in the floating panel.

Wrapper Scripts

Claude Code can be instructed to use wrapper scripts for running tests and builds. These are the same scripts AirTower monitors:

#!/bin/bash
set -e

# Run your test suite
npm test 2>&1

# AirTower automatically picks up the results

#!/bin/bash
set -e

# Run your build
npm run build 2>&1

# AirTower automatically picks up the results

CLAUDE.md Template

Add the following to your project's CLAUDE.md to instruct Claude Code to work with AirTower:

# Project Instructions

## Build & Test
- Run tests: ./run-tests.sh
- Run build: ./run-build.sh
- Use the project's existing build tool instead of writing binaries to /tmp
- Reuse previously-approved build commands rather than creating workarounds

## Task Tracking
- Tasks are tracked in PLAN.md with checkbox syntax
- Bugs are tracked in BUG.md with checkbox headers

## BUG.md Format
Use checkbox syntax in level-2 headers:
- Open: `## [ ] Bug N: Title`
- Fixed: `## [x] Bug N: Title`

Workflow

With AirTower and Claude Code working together, you get a seamless workflow:

• Claude Code reads PLAN.md to understand what tasks to work on
• Claude writes code and runs tests via ./run-tests.sh
• AirTower detects the test results and updates the panel
• Claude updates PLAN.md checkboxes as tasks complete
• AirTower shows the updated task progress in real time
• BUG.md bugs are tracked as Claude discovers and fixes issues

Tips

• Keep your wrapper scripts simple — just call your real test/build commands
• Use PLAN.md for high-level tasks and let Claude handle the implementation details
• Check the AirTower panel to verify tests pass after Claude makes changes
• The floating panel stays visible while Claude works, giving you real-time feedback