@rely-ai/caliber 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Caliber AI
+
+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,134 @@
+# Caliber
+
+Open-source CLI that analyzes your project and generates optimized configuration files for AI coding agents (Claude Code, Cursor). Bring your own LLM — supports Anthropic, OpenAI, Google Vertex AI, and any OpenAI-compatible endpoint.
+
+## Installation
+
+```bash
+npm install -g @rely-ai/caliber
+```
+
+## Quick Start
+
+```bash
+# Option 1: Set your API key as an environment variable
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# Option 2: Interactive setup
+caliber config
+
+# Analyze your project and generate agent configs
+caliber init
+```
+
+## What It Does
+
+Caliber scans your codebase — languages, frameworks, file structure, existing configs — and generates tailored configuration files:
+
+- **CLAUDE.md** — Project context for Claude Code (commands, architecture, conventions)
+- **.cursorrules** / **.cursor/rules/** — Rules for Cursor
+- **Skills** — Reusable skill files following the [OpenSkills](https://agentskills.io) standard
+
+If you already have these files, Caliber audits them against your actual codebase and suggests targeted improvements — keeping what works, fixing what's stale, adding what's missing.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `caliber init` | Scan project and generate agent config |
+| `caliber update` | Re-analyze and regenerate (alias: `regenerate`, `regen`) |
+| `caliber config` | Configure LLM provider, API key, and model |
+| `caliber refresh` | Update docs based on recent git changes |
+| `caliber score` | Score your config quality (deterministic, no LLM) |
+| `caliber recommend` | Discover skills from [skills.sh](https://skills.sh) |
+| `caliber undo` | Revert all changes made by Caliber |
+| `caliber status` | Show current setup status |
+| `caliber hooks install` | Install auto-refresh hook for Claude Code |
+| `caliber hooks remove` | Remove auto-refresh hook |
+| `caliber hooks status` | Show installed hooks |
+| `caliber learn install` | Install session learning hooks |
+| `caliber learn status` | Show learned insights from sessions |
+| `caliber learn observe` | Manually feed a tool event for analysis |
+| `caliber learn finalize` | Analyze captured events and extract patterns |
+| `caliber learn remove` | Remove learning hooks |
+
+## Supported LLM Providers
+
+| Provider | Environment Variable | Notes |
+|----------|---------------------|-------|
+| **Anthropic** | `ANTHROPIC_API_KEY` | Recommended. Claude Sonnet 4.6 default. |
+| **Google Vertex AI** | `VERTEX_PROJECT_ID` or `GCP_PROJECT_ID` | Uses Application Default Credentials (ADC) by default. Region defaults to `us-east5`. Set `VERTEX_REGION` to override, `VERTEX_SA_CREDENTIALS` for service account JSON. |
+| **OpenAI** | `OPENAI_API_KEY` | GPT-4.1 default. |
+| **Custom endpoint** | `OPENAI_API_KEY` + `OPENAI_BASE_URL` | Any OpenAI-compatible API (Ollama, vLLM, Together, etc.) |
+
+Override the model with `CALIBER_MODEL=<model-name>` or via `caliber config`.
+
+### Vertex AI Setup
+
+```bash
+# Minimal — uses gcloud ADC and defaults
+export VERTEX_PROJECT_ID=my-gcp-project
+caliber init
+
+# With custom region
+export VERTEX_PROJECT_ID=my-gcp-project
+export VERTEX_REGION=europe-west1
+caliber init
+
+# With service account credentials (inline JSON)
+export VERTEX_PROJECT_ID=my-gcp-project
+export VERTEX_SA_CREDENTIALS='{"type":"service_account",...}'
+caliber init
+
+# With service account credentials (file path via GOOGLE_APPLICATION_CREDENTIALS)
+export VERTEX_PROJECT_ID=my-gcp-project
+export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
+caliber init
+```
+
+## How It Works
+
+1. **Scan** — Analyzes your code, dependencies, file structure, and existing agent configs
+2. **Generate** — LLM creates config files tailored to your project
+3. **Review** — You accept, refine via chat, or decline the proposed changes
+4. **Apply** — Config files are written to your project with backups
+
+### Auto-refresh
+
+After init, Caliber installs a Claude Code hook that automatically updates your docs when code changes:
+
+```bash
+caliber hooks install    # Install auto-refresh hook
+caliber hooks remove     # Remove it
+```
+
+### Session Learning
+
+Caliber can observe your Claude Code sessions and extract reusable instructions:
+
+```bash
+caliber learn install    # Install learning hooks
+caliber learn status     # Check what's been captured
+```
+
+## Requirements
+
+- Node.js >= 20
+- An API key for a supported LLM provider
+
+## Contributing
+
+```bash
+git clone https://github.com/rely-ai-org/caliber.git
+cd caliber
+npm install
+npm run dev      # Watch mode
+npm run test     # Run tests
+npm run build    # Compile
+```
+
+This project uses [conventional commits](https://www.conventionalcommits.org/) — `feat:` for features, `fix:` for bug fixes. See the [CLAUDE.md](./CLAUDE.md) for architecture details.
+
+## License
+
+MIT