aircana 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d98fe572b3ff149c8e0eb6dc6f4f5bc8f446c6216fa11d8daf3c377be199ec7f
+  data.tar.gz: fb04a40e9f5fea114a047091c4e3f2c91981bb5bfa85388c26a5f755de05e07d
+SHA512:
+  metadata.gz: 03e138268aa044dfdc1b7101f719f659d78ae8ac873e3bd8f7f5efd033cacd390314f0d522dcc1b6488fb9c53c0abaa83d502cab2ea558e0d18f58b53148629b
+  data.tar.gz: f5b5d624c379f63921e87f640269fa30772dadde5c923bf3df48ff356b30ee22b02876ad3c4244dad6d13be4279f36f77a1a18f031e56952f981febfb01a2fe4

data/.devcontainer/devcontainer.json

@@ -0,0 +1,36 @@
+{
+  "name": "Aircana",
+  "dockerComposeFile": "../compose.yml",
+  "service": "app",
+  "workspaceFolder": "/app",
+  "shutdownAction": "stopCompose",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "Shopify.ruby-extensions-pack",
+        "Shopify.ruby-lsp",
+        "LoranKloeze.ruby-rubocop-revived"
+      ],
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "bash",
+        "ruby.lsp.enabledFeatures": {
+          "codeActions": true,
+          "diagnostics": true,
+          "documentHighlights": true,
+          "documentLink": true,
+          "documentSymbols": true,
+          "foldingRanges": true,
+          "formatting": true,
+          "hover": true,
+          "inlayHint": true,
+          "onTypeFormatting": true,
+          "selectionRanges": true,
+          "semanticHighlighting": true,
+          "completion": true
+        }
+      }
+    }
+  },
+  "postCreateCommand": "echo 'Dev container ready!'",
+  "remoteUser": "docker"
+}

data/.dockerignore

@@ -0,0 +1,14 @@
+.git
+.gitignore
+README.md
+Dockerfile
+.dockerignore
+compose.yml
+.DS_Store
+node_modules
+*.log
+tmp/
+.byebug_history
+coverage/
+.rspec
+spec/

data/.rspec_status

@@ -0,0 +1,106 @@
+example_id                                                   | status | run_time        |
+------------------------------------------------------------ | ------ | --------------- |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:1:1:1]   | passed | 0.00684 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:1:2:1]   | passed | 0.00196 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:1:3:1]   | passed | 0.003 seconds   |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:1:4:1]   | passed | 0.00697 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:1:4:2:1] | passed | 0.01864 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:1:5:1]   | passed | 0.0032 seconds  |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:2:1]     | passed | 0.00221 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:2:2]     | passed | 0.00253 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:3:1]     | passed | 0.00089 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:3:2]     | passed | 0.00074 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:3:3]     | passed | 0.00082 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:3:4]     | passed | 0.00084 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:3:5]     | passed | 0.00101 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:3:6]     | passed | 0.00099 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:3:7]     | passed | 0.00082 seconds |
+./spec/aircana/cli/commands/add_directory_spec.rb[1:3:8]     | passed | 0.00071 seconds |
+./spec/aircana/cli/commands/agents_spec.rb[1:1:1:1]          | passed | 0.00044 seconds |
+./spec/aircana/cli/commands/agents_spec.rb[1:1:1:2]          | passed | 0.00055 seconds |
+./spec/aircana/cli/commands/agents_spec.rb[1:1:1:3]          | passed | 0.00038 seconds |
+./spec/aircana/cli/commands/agents_spec.rb[1:1:2:1]          | passed | 0.0013 seconds  |
+./spec/aircana/cli/commands/agents_spec.rb[1:1:3:1]          | passed | 0.00038 seconds |
+./spec/aircana/cli/commands/agents_spec.rb[1:1:3:2]          | passed | 0.00028 seconds |
+./spec/aircana/cli/commands/agents_spec.rb[1:2:1]            | passed | 0.0002 seconds  |
+./spec/aircana/cli/commands/plan_spec.rb[1:1:1:1]            | passed | 0.00692 seconds |
+./spec/aircana/cli/commands/plan_spec.rb[1:1:2:1]            | passed | 0.00514 seconds |
+./spec/aircana/cli/commands/plan_spec.rb[1:1:3:1]            | passed | 0.00046 seconds |
+./spec/aircana/cli/commands/work_spec.rb[1:1:1:1]            | passed | 0.00433 seconds |
+./spec/aircana/cli/commands/work_spec.rb[1:1:2:1]            | passed | 0.00552 seconds |
+./spec/aircana/cli/commands/work_spec.rb[1:1:3:1]            | passed | 0.00052 seconds |
+./spec/aircana/configuration_spec.rb[1:1:1]                  | passed | 0.00114 seconds |
+./spec/aircana/configuration_spec.rb[1:2:1]                  | passed | 0.00008 seconds |
+./spec/aircana/configuration_spec.rb[1:3:1]                  | passed | 0.00007 seconds |
+./spec/aircana/configuration_spec.rb[1:4:1]                  | passed | 0.00007 seconds |
+./spec/aircana/configuration_spec.rb[1:4:2]                  | passed | 0.00007 seconds |
+./spec/aircana/contexts/confluence_spec.rb[1:1:1:1]          | passed | 0.00174 seconds |
+./spec/aircana/contexts/confluence_spec.rb[1:1:1:2]          | passed | 0.00052 seconds |
+./spec/aircana/contexts/confluence_spec.rb[1:1:1:3]          | passed | 0.00092 seconds |
+./spec/aircana/contexts/confluence_spec.rb[1:1:2:1]          | passed | 0.0002 seconds  |
+./spec/aircana/contexts/confluence_spec.rb[1:1:2:2]          | passed | 0.00015 seconds |
+./spec/aircana/contexts/confluence_spec.rb[1:1:2:3]          | passed | 0.00013 seconds |
+./spec/aircana/contexts/confluence_spec.rb[1:1:3:1]          | passed | 0.00034 seconds |
+./spec/aircana/contexts/confluence_spec.rb[1:1:3:2]          | passed | 0.00035 seconds |
+./spec/aircana/contexts/local_spec.rb[1:1:1]                 | passed | 0.00177 seconds |
+./spec/aircana/contexts/local_spec.rb[1:1:2]                 | passed | 0.00103 seconds |
+./spec/aircana/contexts/local_spec.rb[1:1:3]                 | passed | 0.00099 seconds |
+./spec/aircana/contexts/local_spec.rb[1:1:4]                 | passed | 0.00098 seconds |
+./spec/aircana/contexts/local_spec.rb[1:1:5]                 | passed | 0.00093 seconds |
+./spec/aircana/contexts/local_spec.rb[1:1:6]                 | passed | 0.001 seconds   |
+./spec/aircana/contexts/local_spec.rb[1:1:7]                 | passed | 0.00141 seconds |
+./spec/aircana/contexts/local_spec.rb[1:1:8]                 | passed | 0.00099 seconds |
+./spec/aircana/fzf_helper_spec.rb[1:1:1:1]                   | passed | 0.00022 seconds |
+./spec/aircana/fzf_helper_spec.rb[1:1:1:2]                   | passed | 0.00016 seconds |
+./spec/aircana/fzf_helper_spec.rb[1:1:1:3]                   | passed | 0.0002 seconds  |
+./spec/aircana/fzf_helper_spec.rb[1:1:2:1]                   | passed | 0.00022 seconds |
+./spec/aircana/fzf_helper_spec.rb[1:1:3:1]                   | passed | 0.00019 seconds |
+./spec/aircana/fzf_helper_spec.rb[1:2:1:1]                   | passed | 0.0001 seconds  |
+./spec/aircana/fzf_helper_spec.rb[1:2:1:2]                   | passed | 0.0001 seconds  |
+./spec/aircana/fzf_helper_spec.rb[1:2:1:3]                   | passed | 0.00303 seconds |
+./spec/aircana/fzf_helper_spec.rb[1:2:2:1]                   | passed | 0.00013 seconds |
+./spec/aircana/fzf_helper_spec.rb[1:2:2:2]                   | passed | 0.00008 seconds |
+./spec/aircana/generators/agents_generator_spec.rb[1:1:1]    | passed | 0.00003 seconds |
+./spec/aircana/generators/agents_generator_spec.rb[1:2:1]    | passed | 0.0003 seconds  |
+./spec/aircana/generators/agents_generator_spec.rb[1:2:2]    | passed | 0.00014 seconds |
+./spec/aircana/generators/agents_generator_spec.rb[1:3:1:1]  | passed | 0.00005 seconds |
+./spec/aircana/generators/agents_generator_spec.rb[1:3:1:2]  | passed | 0.00004 seconds |
+./spec/aircana/generators/agents_generator_spec.rb[1:3:2:1]  | passed | 0.00004 seconds |
+./spec/aircana/generators/agents_generator_spec.rb[1:3:2:2]  | passed | 0.00004 seconds |
+./spec/aircana/generators/agents_generator_spec.rb[1:4:1:1]  | passed | 0.00004 seconds |
+./spec/aircana/generators/agents_generator_spec.rb[1:4:2:1]  | passed | 0.00004 seconds |
+./spec/aircana/human_logger_spec.rb[1:1:1]                   | passed | 0.00005 seconds |
+./spec/aircana/human_logger_spec.rb[1:2:1]                   | passed | 0.00013 seconds |
+./spec/aircana/human_logger_spec.rb[1:3:1]                   | passed | 0.00004 seconds |
+./spec/aircana/human_logger_spec.rb[1:4:1]                   | passed | 0.00003 seconds |
+./spec/aircana/human_logger_spec.rb[1:5:1]                   | passed | 0.00003 seconds |
+./spec/aircana/human_logger_spec.rb[1:5:2]                   | passed | 0.00003 seconds |
+./spec/aircana/human_logger_spec.rb[1:5:3]                   | passed | 0.00003 seconds |
+./spec/aircana/human_logger_spec.rb[1:5:4]                   | passed | 0.00003 seconds |
+./spec/aircana/human_logger_spec.rb[1:5:5]                   | passed | 0.00003 seconds |
+./spec/aircana/human_logger_spec.rb[1:5:6]                   | passed | 0.00003 seconds |
+./spec/aircana/human_logger_spec.rb[1:5:7]                   | passed | 0.00005 seconds |
+./spec/aircana/human_logger_spec.rb[1:6:1]                   | passed | 0.00003 seconds |
+./spec/aircana/llm/claude_client_spec.rb[1:1:1:1]            | passed | 0.00038 seconds |
+./spec/aircana/llm/claude_client_spec.rb[1:1:1:2]            | passed | 0.00034 seconds |
+./spec/aircana/llm/claude_client_spec.rb[1:1:1:3]            | passed | 0.0003 seconds  |
+./spec/aircana/llm/claude_client_spec.rb[1:1:1:4]            | passed | 0.0004 seconds  |
+./spec/aircana/llm/claude_client_spec.rb[1:1:2:1]            | passed | 0.00047 seconds |
+./spec/aircana/llm/claude_client_spec.rb[1:1:2:2]            | passed | 0.0003 seconds  |
+./spec/aircana/llm/claude_client_spec.rb[1:1:3:1]            | passed | 0.00032 seconds |
+./spec/aircana/llm/claude_client_spec.rb[1:2:1]              | passed | 0.0003 seconds  |
+./spec/aircana/llm/claude_client_spec.rb[1:2:2]              | passed | 0.00029 seconds |
+./spec/aircana/llm/claude_client_spec.rb[1:3:1:1]            | passed | 0.00021 seconds |
+./spec/aircana/llm/claude_client_spec.rb[1:3:1:2]            | passed | 0.00028 seconds |
+./spec/aircana/system_checker_spec.rb[1:1:1:1]               | passed | 0.0003 seconds  |
+./spec/aircana/system_checker_spec.rb[1:1:2:1]               | passed | 0.00038 seconds |
+./spec/aircana/system_checker_spec.rb[1:1:3:1]               | passed | 0.0006 seconds  |
+./spec/aircana/system_checker_spec.rb[1:2:1]                 | passed | 0.00022 seconds |
+./spec/aircana/system_checker_spec.rb[1:2:2]                 | passed | 0.00019 seconds |
+./spec/aircana/system_checker_spec.rb[1:3:1]                 | passed | 0.00019 seconds |
+./spec/aircana/system_checker_spec.rb[1:3:2]                 | passed | 0.00027 seconds |
+./spec/aircana/system_checker_spec.rb[1:3:3]                 | passed | 0.00026 seconds |
+./spec/aircana/system_checker_spec.rb[1:3:4]                 | passed | 0.00027 seconds |
+./spec/aircana/system_checker_spec.rb[1:3:5]                 | passed | 0.0002 seconds  |
+./spec/aircana_spec.rb[1:1]                                  | passed | 0.00005 seconds |
+./spec/aircana_spec.rb[1:2]                                  | passed | 0.00083 seconds |

data/.rubocop.yml

@@ -0,0 +1,33 @@
+AllCops:
+  TargetRubyVersion: 3.3
+  NewCops: enable
+  Exclude:
+    - 'bin/**/*'
+    - 'vendor/**/*'
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/ClassLength:
+  Exclude:
+    - 'lib/aircana/human_logger.rb'
+    - 'lib/aircana/system_checker.rb'
+    - 'lib/aircana/cli/commands/add_directory.rb'
+
+Metrics/ModuleLength:
+  Exclude:
+    - 'lib/aircana/cli/commands/add_directory.rb'

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-09-03
+
+### Added
+- Initial release
+- Context management for AI agents
+- File organization utilities
+- Template generation
+- Claude Code integration
+- CLI interface with Thor
+- Commands: add_files, clear_files, dump_context, generate, install

data/CLAUDE.md

@@ -0,0 +1,58 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+### Development
+- `bundle exec exe/aircana <command>` - Run commands in development mode
+- `bundle install` - Install dependencies
+- `bin/setup` - Set up development environment
+- `bin/console` - Interactive prompt for experimentation
+
+### Testing and Quality
+- `rake spec` or `bundle exec rspec` - Run tests
+- `bundle exec rubocop` - Run linter
+- `rake` - Run both tests and linter (default task)
+
+### Gem Management
+- `bundle exec rake install` - Install gem locally
+- `bundle exec rake release` - Release new version (updates version, creates git tag, pushes to rubygems)
+
+### Aircana CLI Commands
+- `aircana add-files` - Interactively add files to current context
+- `aircana add-dir [DIRECTORY_PATH]` - Add all files from directory to context
+- `aircana clear-files` - Remove all files from relevant files
+- `aircana dump-context <agent_name>` - Dump context for specified agent
+- `aircana generate` - Generate all configured files
+- `aircana install` - Install generated files to Claude Code config
+- `aircana agents create` - Create a new agent
+- `aircana agents refresh <agent>` - Refresh agent knowledge from Confluence pages with matching labels
+
+## Architecture
+
+### Core Structure
+Aircana is a Ruby gem that provides context management and workflow utilities for AI agents, specifically Claude Code. The main components:
+
+- **CLI Layer** (`lib/aircana/cli/`): Thor-based command line interface with subcommands
+- **Contexts** (`lib/aircana/contexts/`): Manages different types of context (relevant files, local, confluence)
+- **Generators** (`lib/aircana/generators/`): Template generation system for Claude Code integration
+- **Configuration** (`lib/aircana/configuration.rb`): Centralized configuration management
+
+### Key Concepts
+- **Relevant Files**: Current working set of important files stored in `.aircana/relevant_files/`
+- **Agents**: Knowledge encapsulation with long-term memory and domain knowledge
+- **Context Management**: Integration with Claude Code through generated templates and configurations
+
+### File Organization
+- Configuration files stored in `~/.aircana` (global) and `.aircana/` (project-local)
+- Claude Code integration through `~/.claude` and `./.claude` directories
+- Generated output goes to `~/.aircana/aircana.out` by default
+
+### Dependencies
+- Thor (~> 0.19.1) for CLI framework  
+- tty-prompt (~> 0.23.1) for interactive prompts
+- Ruby >= 3.3.0 required
+
+### Testing
+Uses RSpec for testing with specs in `spec/` directory. Run individual tests with standard RSpec patterns.

data/Dockerfile

@@ -0,0 +1,17 @@
+FROM instructure/ruby:3.3-jammy
+
+USER root
+RUN apt-get update && apt-get install -y git fzf && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+COPY . .
+
+RUN chown -R docker:docker /app
+
+USER docker
+
+# Install gems to a path owned by docker user
+RUN bundle config set --local path '/app/vendor/bundle'
+RUN bundle install
+
+CMD ["tail", "-f", "/dev/null"]

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Weston Dransfield
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,251 @@
+# Aircana
+
+A Ruby CLI utility for context management and Claude Code integration. Aircana helps manage relevant files for development sessions, create specialized Claude Code agents, and optionally sync knowledge from Confluence.
+
+[![Ruby](https://github.com/westonkd/aircana/actions/workflows/main.yml/badge.svg)](https://github.com/westonkd/aircana/actions/workflows/main.yml)
+[![Gem Version](https://badge.fury.io/rb/aircana.svg)](https://badge.fury.io/rb/aircana)
+
+## Installation
+
+Install the gem:
+
+```bash
+gem install aircana
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'aircana'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+Verify installation and check dependencies:
+
+```bash
+aircana doctor
+```
+
+## Prerequisites
+
+### Required Dependencies
+- Ruby >= 3.3.0
+- `git` (version control operations)
+- `fzf` (interactive file selection)
+
+### Optional Dependencies
+- `bat` (enhanced file previews, falls back to `cat`)
+- `fd` (faster file searching, falls back to `find`)
+
+### For Confluence Integration (Optional)
+- Access to a Confluence instance
+- Confluence API token
+- Appropriate permissions to read pages and labels
+
+## Core Concepts
+
+Aircana provides two main independent features:
+
+### 1. Relevant Files Management
+Track and manage a curated set of "relevant files" - the current working set of important files for your development session. This context is automatically available to Claude Code sessions.
+
+**This works completely independently from agents** - you can use relevant files without creating any agents.
+
+### 2. Specialized Agents (Optional)
+Create Claude Code agents with:
+- **Domain Knowledge**: Focused expertise in specific areas
+- **Confluence Integration**: Knowledge sync from labeled pages (requires Confluence setup)
+- **Customizable Models**: Choose from different Claude models and interface colors
+
+**Agents work independently from relevant files** - you can create agents without managing relevant files.
+
+### Knowledge Sources
+- **Relevant Files**: Current working set managed by Aircana (independent feature)
+- **Confluence Pages**: Fetched based on agent labels (agent feature, requires setup)
+- **Local Context**: Project-specific files and configurations
+
+## What Aircana Does
+
+- **File Context Management**: Track and manage relevant files for Claude Code sessions
+- **Agent Configuration**: Create and configure specialized Claude Code agents
+- **Confluence Integration**: Sync knowledge from Confluence pages to agents (optional)
+- **Claude Code Shortcuts**: Quick-launch Claude Code with pre-configured agents
+- **System Health Checks**: Validate dependencies and configuration
+
+## Quick Start
+
+1. **Install and verify**:
+   ```bash
+   gem install aircana
+   aircana doctor
+   ```
+
+2. **Set up your project**:
+   ```bash
+   cd your-project
+   aircana install    # Set up Aircana integration in this project
+   ```
+
+3. **Add files to context**:
+   ```bash
+   aircana add-files    # Interactive selection
+   ```
+
+   Then in Claude Code, include them with whenever you want to reload the files into the current context:
+   ```
+   /ac-add-relevant-files
+   ```
+
+4. **Create an agent** (optional, but powerful with Confluence):
+   ```bash
+   aircana agents create    # Tag Confluence pages with the agent's name before or after creation to pull that knowledge into the agent's knowledge base. 
+   ```
+
+5. **Launch Claude Code**:
+
+   _These command are still very much a work in progress_  
+
+   ```bash
+   aircana plan    # For planning work
+   aircana work    # For implementation
+   ```
+
+## Confluence Setup (Optional)
+
+To use agent knowledge sync features, you'll need to configure Confluence integration:
+
+### 1. Generate Confluence API Token
+
+1. Go to your Confluence instance
+2. Click your profile picture → **Account Settings**
+3. Select **Security** → **Create and manage API tokens**
+4. Click **Create API token**
+5. Give it a descriptive name (e.g., "Aircana Integration")
+6. Copy the generated token
+
+### 2. Set Environment Variables
+
+Add these to your shell profile (`.bashrc`, `.zshrc`, etc.):
+
+```bash
+export CONFLUENCE_BASE_URL="https://your-company.atlassian.net"
+export CONFLUENCE_USERNAME="your.email@company.com"
+export CONFLUENCE_API_TOKEN="your-generated-token"
+```
+
+Reload your shell or run `source ~/.zshrc` (or your shell config file).
+
+### 3. Verify Configuration
+
+```bash
+aircana doctor
+```
+
+This will check if Confluence is properly configured.
+
+## Agent Workflow Tutorial
+
+Here's a complete example of creating an agent and syncing knowledge from Confluence:
+
+### 1. Create an Agent
+
+```bash
+aircana agents create
+```
+
+You'll be prompted for:
+- **Agent name**: e.g., "backend-api"
+- **Description**: e.g., "Helps with backend API development"
+- **Model**: Choose from sonnet, haiku, or inherit
+- **Color**: Choose interface color
+
+### 2. Tag Confluence Pages
+
+In Confluence, add the label `backend-api` (matching your agent name) to relevant pages:
+
+1. Open a Confluence page with relevant documentation
+2. Click **...** → **Edit labels**
+3. Add label: `backend-api`
+4. Save
+
+Repeat for all pages you want the agent to know about.
+
+### 3. Sync Knowledge
+
+```bash
+aircana agents refresh backend-api
+```
+
+This downloads all Confluence pages labeled `backend-api` and makes them available to your agent.
+
+### 4. Use the Agent
+
+Once created with a good description, Claude Code will automatically use your agent when appropriate during conversations. You can also explicitly request a specific agent:
+
+```
+Ask backend-api for a code review of this function
+Ask backend-api to help debug this API endpoint
+Ask rspec-test-writer to write and run tests for @file
+```
+
+The agent will have access to all the Confluence knowledge you synced.
+
+### 5. Update Knowledge
+
+Whenever you update Confluence pages or add new ones with the agent label:
+
+```bash
+aircana agents refresh backend-api
+```
+
+
+## All Commands
+
+### File Management
+```bash
+aircana add-files          # Interactively select files to add to context
+aircana add-dir [PATH]     # Add all files from directory
+aircana clear-files        # Clear current file context
+aircana dump-context [AGENT] # View current context for agent
+```
+
+### Agent Management
+```bash
+aircana agents create      # Create new agent interactively
+aircana agents refresh [AGENT] # Sync agent knowledge from Confluence
+```
+
+### Claude Code Integration
+```bash
+aircana plan              # Launch Claude Code with planner agent (experimental)
+aircana work              # Launch Claude Code with worker agent (experimental)
+aircana generate          # Generate Claude Code configuration files
+aircana install           # Install generated files to Claude Code
+```
+
+### System
+```bash
+aircana doctor            # Check system health and dependencies
+aircana doctor --verbose  # Show detailed dependency information
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+Run commands in development with `bundle exec exe/aircana <command>`
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/westonkd/aircana.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/SECURITY.md

@@ -0,0 +1,15 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 0.1.x   | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+Please report security vulnerabilities by emailing weston@dransfield.dev.
+
+Do not report security vulnerabilities through public GitHub issues.
+
+We will respond to security reports within 48 hours and provide regular updates on the status of any reported vulnerabilities.

data/compose.yml

@@ -0,0 +1,13 @@
+services:
+  app:
+    build: .
+    volumes:
+      - .:/app
+      - bundle_cache:/usr/local/bundle
+    environment:
+      - BUNDLE_PATH=/usr/local/bundle
+    stdin_open: true
+    tty: true
+
+volumes:
+  bundle_cache:

data/exe/aircana

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require "aircana"
+
+Aircana.configure do |config|
+  config.confluence_base_url = ENV.fetch("CONFLUENCE_BASE_URL", nil)
+  config.confluence_username = ENV.fetch("CONFLUENCE_USERNAME", nil)
+  config.confluence_api_token = ENV.fetch("CONFLUENCE_API_TOKEN", nil)
+end
+
+Aircana::CLI::App.start(ARGV)