contextloop-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ContextLoop
+
+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.

package/README.md

@@ -0,0 +1,223 @@
+# ContextLoop CLI
+
+The official command-line interface for [ContextLoop](https://contextloop.io) - upload, download, and manage documents efficiently.
+
+> **Important**: The correct domain is **contextloop.io** (NOT contextloop.ai)
+
+## Features
+
+- **Token-efficient uploads**: Read files directly from disk without generating tokens
+- **Pipe support**: Stream content from stdin for AI agent integration
+- **Batch operations**: Upload multiple files with glob patterns
+- **Cross-platform**: Works on macOS, Windows, and Linux
+- **Secure**: Credentials stored in OS keychain
+- **Local development**: Easy localhost support for testing
+
+## Installation
+
+### From npm (once published)
+```bash
+npm install -g contextloop-cli
+# or
+pnpm add -g contextloop-cli
+```
+
+### Local Development
+```bash
+# Clone and install
+cd ~/Git/contextloop-cli
+pnpm install
+pnpm build
+
+# Option 1: Run directly
+node ./dist/index.js --help
+
+# Option 2: Link globally
+pnpm link --global
+contextloop --help
+```
+
+## Quick Start
+
+```bash
+# Login with API key
+contextloop auth login --api-key YOUR_API_KEY
+
+# Or interactive login (opens browser)
+contextloop auth login
+
+# Set default project
+contextloop project use my-project
+
+# Upload a document
+contextloop document upload ./docs/readme.md
+
+# Upload from stdin
+cat file.md | contextloop document upload - --title "My Doc"
+
+# Download a document
+contextloop document download <document-id>
+
+# List documents
+contextloop document list --tree
+```
+
+## Commands
+
+### Authentication
+
+```bash
+contextloop auth login              # Interactive login
+contextloop auth login --api-key    # Login with API key
+contextloop auth logout             # Clear credentials
+contextloop auth whoami             # Show current user
+```
+
+### Projects
+
+```bash
+contextloop project list            # List projects
+contextloop project use <id|slug>   # Set default project
+contextloop project info            # Show project details
+contextloop project current         # Show default project
+```
+
+### Documents
+
+```bash
+contextloop document list [--tree]                    # List documents
+contextloop document upload <file> [--path <path>]    # Upload document
+contextloop document download <id> [-o file]          # Download document
+contextloop document update <id> <file>               # Update document
+contextloop document delete <id>                      # Delete document
+contextloop document info <id>                        # Show metadata
+contextloop document versions <id>                    # List versions
+```
+
+### Context
+
+```bash
+contextloop context list                    # List context items
+contextloop context upload <file>           # Upload context
+contextloop context download <id> [-o file] # Download context
+contextloop context delete <id>             # Delete context
+```
+
+### Comments
+
+```bash
+contextloop comment list <document-id>                      # List comments
+contextloop comment add <document-id> --body "text"         # Add comment
+contextloop comment resolve <comment-id>                    # Resolve comment
+```
+
+## Global Options
+
+```
+-V, --version              Output version number
+-p, --project <id|slug>    Project ID or slug (overrides default)
+-f, --format <format>      Output format: text, json (default: text)
+-q, --quiet                Suppress non-essential output
+-v, --verbose              Enable verbose logging
+--no-color                 Disable colored output
+-h, --help                 Display help
+```
+
+## Environment Variables
+
+```bash
+# Production (default)
+CONTEXTLOOP_API_URL=https://contextloop.io/api
+
+# Local development - use any of these:
+CONTEXTLOOP_API_URL=local                      # Shorthand for localhost:3000
+CONTEXTLOOP_API_URL=localhost                  # Shorthand for localhost:3000
+CONTEXTLOOP_API_URL=http://localhost:3000/api  # Explicit localhost
+
+# Authentication
+CONTEXTLOOP_API_KEY=cl_key_xxxxx               # API key
+
+# Default project (optional)
+CONTEXTLOOP_PROJECT_ID=uuid-here
+```
+
+## Local Development Testing
+
+To test the CLI against a local ContextLoop instance:
+
+```bash
+# Option 1: Set environment variable
+export CONTEXTLOOP_API_URL=local
+contextloop auth whoami
+
+# Option 2: Use explicit URL
+CONTEXTLOOP_API_URL=http://localhost:3000/api contextloop project list
+
+# Option 3: One-liner
+CONTEXTLOOP_API_URL=local contextloop document list
+```
+
+## Configuration
+
+Configuration is stored in:
+- **macOS**: `~/Library/Preferences/contextloop-cli-nodejs/config.json`
+- **Linux**: `~/.config/contextloop-cli-nodejs/config.json`
+- **Windows**: `%APPDATA%/contextloop-cli-nodejs/Config/config.json`
+
+Credentials are stored securely in your OS keychain.
+
+## AI Agent Usage
+
+The CLI is designed for AI agent integration (Claude Code, Cline, Cursor):
+
+```bash
+# Upload file without generating tokens
+contextloop document upload ./spec.md --title "Feature Spec"
+
+# Pipe content directly
+echo "# New Doc" | contextloop document upload - --title "Quick Note"
+
+# Batch upload
+contextloop document upload "./docs/**/*.md" --dry-run
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Authentication error |
+| 3 | Permission denied |
+| 4 | Resource not found |
+| 5 | Validation error |
+| 6 | Configuration error |
+| 10 | File system error |
+| 11 | Rate limit exceeded |
+| 12 | Timeout |
+| 13 | File too large |
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/contextloop/contextloop-cli.git
+cd contextloop-cli
+pnpm install
+
+# Build
+pnpm build
+
+# Run tests
+pnpm test
+
+# Run locally
+node ./dist/index.js <command>
+
+# Test against local server
+CONTEXTLOOP_API_URL=local node ./dist/index.js auth whoami
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node