Airsnip is a CLI tool that lets developers push snippets, functions, or entire folders from their terminal and have teammates pull them instantly — no browser, no copy-paste, no Slack code blocks.

Installation

npm install -g airsnip
# or
pnpm add -g airsnip

Quick Start

1. Log in: Authenticate via your browser.

   airsnip login

2. Create a team:

   airsnip team create my-team

3. Push a file:

   airsnip push file src/utils.ts --tag utils

4. Pull a snippet (on a teammate's machine):

   airsnip pull utils

5. Invite a teammate:

   airsnip team invite [email protected]

Command Reference

Authentication

• airsnip login — Interactive browser-based OAuth flow.
• airsnip logout — Clear local session.
• airsnip whoami — Show current authenticated user and active team.

Team Management

• airsnip team create <name> — Create a new team and set it as active.
• airsnip team join <invite-code> — Join an existing team.
• airsnip team invite <email> — Generate an invite link restricted to a specific email.
• airsnip team members — List all members and their roles.
• airsnip team switch <name> — Switch the current active team context.
• airsnip team info — View detailed team info (plan, member count, etc).

Pushing & Pulling

• airsnip push file <path> --tag <tag> — Share a single file.
• airsnip push folder <path> --tag <tag> — Share an entire folder (auto-zipped).
• airsnip push fn <name> --from <path> --tag <tag> — Extract and share a specific function using AST parsing.
• airsnip pull <tag> — Download a snippet to its original path.
• airsnip pull <tag> --into <path> — Download to a custom location.

Browsing & Management

• airsnip list — View all snippets in your current team.
• airsnip list --mine — Filter to only your own pushes.
• airsnip list --pinned — View your bookmarked snippets.
• airsnip search <keyword> — Search snippets by tag or path.
• airsnip show <tag> — Preview snippet content directly in your terminal.
• airsnip diff <tag> — Compare remote version with your local file.

• airsnip delete <tag> — Remove a snippet.
• airsnip rename <old> <new> — Rename a tag.
• airsnip history <tag> — View the version history of a snippet.
• airsnip pin <tag> — Bookmark a snippet locally.

Configuration

Initialize Airsnip in your project root to manage settings like default team and visibility:

airsnip init

Configurations are stored in .airsnip files.

📄 License

MIT