primellm 0.2.0 → 1.0.1

package/README.md

@@ -1,127 +1,97 @@
-# PrimeLLM JavaScript SDK
+# PrimeLLM CLI
 
-Official JavaScript/TypeScript SDK for the PrimeLLM unified AI API.
+> Configure Claude Code and Codex to use PrimeLLM as the backend
 
-PrimeLLM lets you access multiple AI models (GPT-5.1, Claude, Gemini) through a single, simple API.
+A production-grade CLI installer that configures AI coding tools to use PrimeLLM's unified API.
 
-## Installation
+## Quick Start
 
 ```bash
-npm install primellm
+npx primellm
 ```
 
-## Quick Start
+## Features
 
-```javascript
-import PrimeLLM from "primellm";
-
-// Create a client with your API key
-const client = new PrimeLLM({
-  apiKey: "primellm_XXX", // Get from https://primellm.in/dashboard
-});
-
-// Send a chat message
-const response = await client.chat({
-  model: "gpt-5.1",
-  messages: [
-    { role: "system", content: "You are a helpful assistant." },
-    { role: "user", content: "What is TypeScript?" },
-  ],
-});
-
-// Access the response
-console.log(response.choices[0].message.content);
-console.log("Tokens used:", response.usage.total_tokens);
-console.log("Credits left:", response.credits.remaining);
-```
+- 🎨 **Beautiful UI** - ASCII art banner and progress indicators
+- 🔍 **System Detection** - Automatically detects OS, shell, and Node version
+- 🛠 **Tool Selection** - Choose between Claude Code or Codex
+- 📦 **Smart Installation** - Only installs tools if not already present
+- 🔑 **Secure API Key Flow** - Masked input with validation
+- 📁 **Flexible Scope** - System-level or project-level configuration
+
+## Supported Tools
 
-## Available Models
+| Tool | Package | Command |
+|------|---------|---------|
+| Claude Code | `@anthropic-ai/claude-code` | `claude` |
+| Codex | `@openai/codex` | `codex` |
 
-| Model | Description |
-|-------|-------------|
-| `gpt-5.1` | Latest GPT model (default) |
-| `claude-sonnet-4.5` | Claude Sonnet 4.5 |
-| `gemini-3.0` | Gemini 3.0 |
+## Usage
 
-## API Reference
+### Interactive Mode
 
-### Creating a Client
+Simply run the CLI and follow the prompts:
 
-```typescript
-const client = new PrimeLLM({
-  apiKey: "primellm_XXX",  // Required
-  baseURL: "https://api.primellm.in",  // Optional, this is the default
-  timeoutMs: 60000,  // Optional, 60 seconds default
-});
+```bash
+npx primellm
 ```
 
-### client.chat(request)
+### What it Does
 
-Send a chat completion request.
+1. **Detects your system** - Shows OS, shell, and Node version
+2. **Asks which tool** - Claude Code or Codex
+3. **Checks installation** - Skips install if already present
+4. **Gets your API key** - Opens browser if you need to create one
+5. **Configures the tool** - Writes config with PrimeLLM backend
 
-```javascript
-const response = await client.chat({
-  model: "gpt-5.1",
-  messages: [
-    { role: "user", content: "Hello!" }
-  ],
-  temperature: 0.7,  // Optional
-  max_tokens: 1000,  // Optional
-});
-```
+## Configuration
 
-**Response:**
-```javascript
-{
-  id: "chatcmpl_xxx",
-  model: "gpt-5.1",
-  choices: [{
-    index: 0,
-    message: { role: "assistant", content: "..." },
-    finish_reason: "stop"
-  }],
-  usage: {
-    prompt_tokens: 10,
-    completion_tokens: 20,
-    total_tokens: 30
-  },
-  credits: {
-    remaining: 149.99,
-    cost: 0.00006
-  }
-}
-```
+### System-level (recommended)
 
-## TypeScript Support
+Applies to all projects. Config stored in:
+- Claude Code: `~/.claude/config.json`
+- Codex: `~/.codex/config.json`
 
-This SDK is written in TypeScript and includes full type definitions.
+### Project-level
 
-```typescript
-import PrimeLLM, { ChatRequest, ChatResponse } from "primellm";
+Applies to current project only. Config stored in:
+- Claude Code: `./.claude/config.json`
+- Codex: `./.codex/config.json`
 
-const client = new PrimeLLM({ apiKey: "..." });
+## API Key
 
-const request: ChatRequest = {
-  model: "gpt-5.1",
-  messages: [{ role: "user", content: "Hello!" }],
-};
+Your PrimeLLM API key:
+- Must start with `primellm_`
+- Can be created at: https://primellm.in/dashboard/api-keys
 
-const response: ChatResponse = await client.chat(request);
-```
+## Requirements
 
-## Error Handling
-
-```javascript
-try {
-  const response = await client.chat({
-    model: "gpt-5.1",
-    messages: [{ role: "user", content: "Hello!" }],
-  });
-} catch (error) {
-  console.error("API Error:", error.message);
-}
+- Node.js >= 18.0.0
+- npm or npx
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/rishuuu-codesss/primellm-backend.git
+cd primellm-backend/primellm-cli
+
+# Install dependencies
+npm install
+
+# Run in development
+npm run dev
+
+# Build
+npm run build
 ```
 
 ## License
 
 MIT
+
+## Links
+
+- [PrimeLLM Website](https://primellm.in)
+- [API Documentation](https://primellm.in/docs)
+- [Dashboard](https://primellm.in/dashboard)

package/dist/index.d.ts

@@ -1,148 +1,3 @@
-/**
- * PrimeLLM JavaScript SDK v0.2.0
- *
- * Production-grade SDK with streaming, retries, and full API parity.
- *
- * @example
- * import PrimeLLM from "primellm";
- *
- * const client = new PrimeLLM({ apiKey: "primellm_XXX" });
- * const response = await client.chat({
- *   model: "gpt-5.1",
- *   messages: [{ role: "user", content: "Hello!" }],
- * });
- * console.log(response.choices[0].message.content);
- */
-import { ChatRequest, ChatResponse, Message, PrimeLLMClientOptions, EmbeddingsRequest, EmbeddingsResponse, ModelsResponse, CreditsResponse, KeysResponse, KeyCreateResponse } from "./types.js";
-import { StreamChunk } from "./streaming.js";
-export * from "./types.js";
-export * from "./errors.js";
-export { countTokens, setTokenizerAdapter } from "./tokenizer.js";
-export { StreamChunk } from "./streaming.js";
-/**
- * PrimeLLM API Client
- *
- * Production-grade client with streaming, retries, and full API access.
- */
-export declare class PrimeLLM {
-    private apiKey;
-    private baseURL;
-    private timeoutMs;
-    private retry;
-    embeddings: EmbeddingsClient;
-    models: ModelsClient;
-    keys: KeysClient;
-    credits: CreditsClient;
-    tokens: TokensClient;
-    chat: ChatClient;
-    /**
-     * Create a new PrimeLLM client.
-     *
-     * @param options - Configuration options
-     * @param options.apiKey - Your PrimeLLM API key (required)
-     * @param options.baseURL - API base URL (default: "https://api.primellm.in")
-     * @param options.timeoutMs - Request timeout in ms (default: 60000)
-     * @param options.maxRetries - Max retry attempts (default: 3)
-     */
-    constructor(options: PrimeLLMClientOptions);
-    /**
-     * Internal HTTP request with retries and error handling
-     */
-    request<TResponse>(path: string, body?: unknown, options?: {
-        method?: string;
-    }): Promise<TResponse>;
-    /**
-     * Internal streaming request
-     */
-    streamRequest(path: string, body: unknown): AsyncGenerator<StreamChunk, void, unknown>;
-}
-/**
- * Chat sub-client
- */
-declare class ChatClient {
-    private client;
-    constructor(client: PrimeLLM);
-    /**
-     * Send a chat completion request
-     */
-    create(request: ChatRequest): Promise<ChatResponse>;
-    /**
-     * Stream chat completion (async iterator)
-     *
-     * @example
-     * for await (const chunk of client.chat.stream({...})) {
-     *   console.log(chunk.delta?.content);
-     * }
-     */
-    stream(request: ChatRequest): AsyncGenerator<StreamChunk, void, unknown>;
-}
-/**
- * Embeddings sub-client
- */
-declare class EmbeddingsClient {
-    private client;
-    constructor(client: PrimeLLM);
-    /**
-     * Create embeddings for input text
-     */
-    create(request: EmbeddingsRequest): Promise<EmbeddingsResponse>;
-}
-/**
- * Models sub-client
- */
-declare class ModelsClient {
-    private client;
-    constructor(client: PrimeLLM);
-    /**
-     * List available models
-     */
-    list(): Promise<ModelsResponse>;
-}
-/**
- * Keys sub-client
- */
-declare class KeysClient {
-    private client;
-    constructor(client: PrimeLLM);
-    /**
-     * List API keys
-     */
-    list(): Promise<KeysResponse>;
-    /**
-     * Create a new API key
-     */
-    create(label?: string): Promise<KeyCreateResponse>;
-    /**
-     * Revoke an API key
-     */
-    revoke(keyId: number): Promise<{
-        ok: boolean;
-    }>;
-}
-/**
- * Credits sub-client
- */
-declare class CreditsClient {
-    private client;
-    constructor(client: PrimeLLM);
-    /**
-     * Get current credit balance
-     */
-    get(): Promise<CreditsResponse>;
-}
-/**
- * Tokens sub-client (utility)
- */
-declare class TokensClient {
-    /**
-     * Count tokens in text or messages
-     */
-    count(input: string | Message[]): number;
-    /**
-     * Set custom tokenizer adapter
-     */
-    setAdapter(adapter: ((text: string) => number) | null): void;
-}
-export { PrimeLLM as PrimeLLMClient };
-export default PrimeLLM;
+#!/usr/bin/env node
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}