Full Context Swapping for Developer Workflows

A command-line tool that enables seamless switching between different development contexts and AI assistant configurations, keeping your projects clean from tool-specific clutter.

Your repository is for your code, not your tools' config files.

Quick Start

Installation

curl -fsSL https://raw.githubusercontent.com/oswaldo/first/main/install.sh | sh

Usage

# Save your current development context
first save gemini-config --artifacts ".gemini/,GEMINI.md"

# Load a context
first load gemini-config

# Swap to a different setup
first swap claude-config

📚 Documentation

Read the full documentation

• Getting Started
• Command Reference
• Architecture
• Guides (Remote contexts, Dogfooding, etc.)
• SPEC-ROADMAP.md - Feature roadmap and development plan

Features

• Non-invasive tooling: Store AI/linter configs outside your repo.
• Full context swapping: Switch environments with one command.
• Remote contexts: Share team configurations via GitHub URLs (gh://...).
• Native Performance: Built with Scala Native, zero JVM overhead.

Contributing

Contributions are welcome! This project follows spec-driven development practices using the GitHub Spec Kit.

License

MIT Licensed. See LICENSE.