indiecrm-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Sinewe
+
+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,39 @@
+# IndieCRM CLI
+
+The IndieCRM CLI works with the workspaces, pipelines, contacts, companies, and deals in [IndieCRM](https://indiecrm.app). It uses IndieCRM's authenticated MCP API, so data access follows your signed-in account and workspace permissions.
+
+Requires Node.js 22.12 or newer.
+
+## Install
+
+```bash
+npm install -g indiecrm-cli
+indiecrm login
+```
+
+The login command opens IndieCRM in your browser for sign-in and consent. It saves the OAuth session in `~/.config/indiecrm-cli/auth.json` with owner-only permissions. Set `INDIECRM_CONFIG_DIR` to use another configuration directory. For automation, set `INDIECRM_ACCESS_TOKEN` to an existing IndieCRM OAuth access token instead of storing a local session.
+
+## Use
+
+```bash
+indiecrm workspaces
+indiecrm pipeline <app-id>
+indiecrm deals <app-id> --status open
+indiecrm contacts <app-id> --search Jane
+indiecrm companies <app-id> --search Acme
+indiecrm deal:create <app-id> "New opportunity" --value 500 --currency EUR
+indiecrm deal:move <deal-id> <stage-id>
+indiecrm activity:log <app-id> <deal-id> "Sent proposal" --kind email
+```
+
+Commands print JSON for shell scripts and agents. Start with `indiecrm workspaces` to find the app ID for each workspace. `indiecrm tools` shows the live API tool catalog, and `indiecrm call <tool> --input '{"appId":"..."}'` exposes any supported tool directly. `indiecrm status` checks for a local session; `indiecrm logout` removes it.
+
+## Development
+
+```bash
+npm ci
+npm test
+npm pack --dry-run
+```
+
+This repository was forked from `salesprompter-cli`. The IndieCRM package has its own command, authentication, API connection, and release version. Salesprompter commands are not part of the published package.

package/dist/indiecrm/auth.js

@@ -0,0 +1,191 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { createServer } from "node:http";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { Client, StreamableHTTPClientTransport, UnauthorizedError, } from "@modelcontextprotocol/client";
+import { version } from "./version.js";
+const CALLBACK_PORT = 48931;
+const CALLBACK_PATH = "/oauth/callback";
+const CALLBACK_URL = `http://127.0.0.1:${CALLBACK_PORT}${CALLBACK_PATH}`;
+const LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
+export const MCP_URL = "https://indiecrm.app/mcp";
+export function sessionPath() {
+    return path.join(process.env["INDIECRM_CONFIG_DIR"] || path.join(os.homedir(), ".config", "indiecrm-cli"), "auth.json");
+}
+async function readSession() {
+    try {
+        const parsed = JSON.parse(await readFile(sessionPath(), "utf8"));
+        return { clients: parsed.clients ?? {}, tokens: parsed.tokens };
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { clients: {} };
+        throw error;
+    }
+}
+async function writeSession(session) {
+    const file = sessionPath();
+    await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+    await writeFile(file, JSON.stringify(session, null, 2) + "\n", { mode: 0o600 });
+    await import("node:fs/promises").then(({ chmod }) => chmod(file, 0o600));
+}
+export async function logout() {
+    await rm(sessionPath(), { force: true });
+}
+export async function hasSession() {
+    return Boolean(process.env["INDIECRM_ACCESS_TOKEN"] || (await readSession()).tokens?.access_token);
+}
+class IndieCrmOAuthProvider {
+    session;
+    interactive;
+    redirectUrl = CALLBACK_URL;
+    clientMetadata = {
+        client_name: "IndieCRM CLI",
+        redirect_uris: [CALLBACK_URL],
+        application_type: "native",
+        token_endpoint_auth_method: "none",
+        grant_types: ["authorization_code", "refresh_token"],
+        response_types: ["code"],
+    };
+    discovery;
+    verifier;
+    stateValue;
+    constructor(session, interactive) {
+        this.session = session;
+        this.interactive = interactive;
+    }
+    state() {
+        this.stateValue = randomUUID();
+        return this.stateValue;
+    }
+    get expectedState() {
+        return this.stateValue;
+    }
+    clientInformation(ctx) {
+        return ctx ? this.session.clients[ctx.issuer] : undefined;
+    }
+    async saveClientInformation(info, ctx) {
+        if (!ctx)
+            throw new Error("OAuth issuer was not supplied by the server");
+        this.session.clients[ctx.issuer] = info;
+        await writeSession(this.session);
+    }
+    tokens() {
+        return this.session.tokens;
+    }
+    async saveTokens(tokens) {
+        this.session.tokens = tokens;
+        await writeSession(this.session);
+    }
+    redirectToAuthorization(url) {
+        if (!this.interactive)
+            throw new Error("Your IndieCRM session has expired. Run `indiecrm login`.");
+        console.log(`Open this URL to sign in to IndieCRM:\n${url.href}\n`);
+        const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+        const args = process.platform === "win32" ? ["/c", "start", "", url.href] : [url.href];
+        const child = spawn(opener, args, { stdio: "ignore", detached: true });
+        child.on("error", () => { });
+        child.unref();
+    }
+    saveCodeVerifier(verifier) {
+        this.verifier = verifier;
+    }
+    codeVerifier() {
+        if (!this.verifier)
+            throw new Error("Missing OAuth code verifier");
+        return this.verifier;
+    }
+    saveDiscoveryState(state) {
+        this.discovery = state;
+    }
+    discoveryState() {
+        return this.discovery;
+    }
+}
+function makeClient(provider) {
+    const client = new Client({ name: "indiecrm-cli", version });
+    const transport = new StreamableHTTPClientTransport(new URL(MCP_URL), { authProvider: provider });
+    return { client, transport };
+}
+export async function login() {
+    const session = await readSession();
+    delete session.tokens;
+    const provider = new IndieCrmOAuthProvider(session, true);
+    let resolveCallback;
+    let rejectCallback;
+    const callback = new Promise((resolve, reject) => {
+        resolveCallback = resolve;
+        rejectCallback = reject;
+    });
+    const server = createServer((request, response) => {
+        const url = new URL(request.url ?? "/", CALLBACK_URL);
+        if (request.method !== "GET" || url.pathname !== CALLBACK_PATH) {
+            response.writeHead(404).end();
+            return;
+        }
+        if (url.searchParams.get("state") !== provider.expectedState) {
+            response.writeHead(400, { "Content-Type": "text/plain" }).end("Invalid sign-in state. Return to the CLI and retry.");
+            return;
+        }
+        response.writeHead(200, { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "no-store" });
+        response.end("<!doctype html><html><body><h1>IndieCRM CLI connected</h1><p>You can close this tab.</p></body></html>");
+        resolveCallback(url.searchParams);
+    });
+    try {
+        await new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen(CALLBACK_PORT, "127.0.0.1", resolve);
+        });
+        const { client, transport } = makeClient(provider);
+        try {
+            await client.connect(transport);
+            await client.close();
+            console.log("Already signed in to IndieCRM.");
+            return;
+        }
+        catch (error) {
+            if (!(error instanceof UnauthorizedError))
+                throw error;
+        }
+        const timer = setTimeout(() => rejectCallback(new Error("Sign-in timed out after five minutes")), LOGIN_TIMEOUT_MS);
+        let params;
+        try {
+            params = await callback;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (params.has("error"))
+            throw new Error("IndieCRM sign-in was declined or failed");
+        await transport.finishAuth(params);
+        const connected = makeClient(provider);
+        try {
+            await connected.client.connect(connected.transport);
+        }
+        finally {
+            await connected.client.close();
+        }
+        console.log("Signed in to IndieCRM.");
+    }
+    finally {
+        server.close();
+    }
+}
+export async function connect() {
+    const envToken = process.env["INDIECRM_ACCESS_TOKEN"]?.trim();
+    if (envToken) {
+        const client = new Client({ name: "indiecrm-cli", version });
+        await client.connect(new StreamableHTTPClientTransport(new URL(MCP_URL), {
+            authProvider: { token: async () => envToken },
+        }));
+        return client;
+    }
+    const session = await readSession();
+    if (!session.tokens)
+        throw new Error("Sign in first with `indiecrm login` or set INDIECRM_ACCESS_TOKEN.");
+    const { client, transport } = makeClient(new IndieCrmOAuthProvider(session, false));
+    await client.connect(transport);
+    return client;
+}

package/dist/indiecrm/version.js

@@ -0,0 +1,3 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+export const version = require("../../package.json").version;

package/dist/indiecrm-cli.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { connect, hasSession, login, logout } from "./indiecrm/auth.js";
+import { version } from "./indiecrm/version.js";
+const program = new Command()
+    .name("indiecrm")
+    .description("Work with your IndieCRM workspaces, contacts, companies, and deals.")
+    .version(version);
+function positiveInt(value) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 200)
+        throw new Error("Limit must be between 1 and 200");
+    return parsed;
+}
+function nonnegativeNumber(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        throw new Error("Value must be a nonnegative number");
+    return parsed;
+}
+function print(value) {
+    console.log(JSON.stringify(value, null, 2));
+}
+async function call(name, args) {
+    const client = await connect();
+    try {
+        const result = await client.callTool({ name, arguments: args });
+        if (result.isError) {
+            const message = result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
+            throw new Error(message || `${name} failed`);
+        }
+        if (result.structuredContent) {
+            print(result.structuredContent);
+            return;
+        }
+        const text = result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
+        try {
+            print(JSON.parse(text));
+        }
+        catch {
+            console.log(text);
+        }
+    }
+    finally {
+        await client.close();
+    }
+}
+program.command("login").description("Sign in through indiecrm.app").action(login);
+program.command("logout").description("Remove the local sign-in session").action(async () => {
+    await logout();
+    console.log("Signed out of IndieCRM CLI.");
+});
+program.command("status").description("Show whether a local session is available").action(async () => {
+    print({ signedIn: await hasSession() });
+});
+program.command("workspaces").description("List workspaces and app IDs").action(() => call("list_workspaces", {}));
+program.command("pipeline <app-id>").description("List pipelines and stages for an app")
+    .action((appId) => call("list_pipeline", { appId }));
+program.command("deals <app-id>").description("List deals for an app")
+    .option("--status <status>", "open, won, or lost")
+    .option("--limit <n>", "maximum rows (1-200)", positiveInt)
+    .action((appId, options) => {
+    if (options.status && !["open", "won", "lost"].includes(options.status))
+        throw new Error("Status must be open, won, or lost");
+    return call("list_deals", { appId, ...options });
+});
+program.command("contacts <app-id>").description("List or search contacts")
+    .option("--search <name>", "case-insensitive name search")
+    .option("--limit <n>", "maximum rows (1-200)", positiveInt)
+    .action((appId, options) => call("list_contacts", { appId, ...options }));
+program.command("companies <app-id>").description("List or search companies")
+    .option("--search <name>", "case-insensitive name search")
+    .option("--limit <n>", "maximum rows (1-200)", positiveInt)
+    .action((appId, options) => call("list_companies", { appId, ...options }));
+program.command("deal:create <app-id> <title>").description("Create a deal")
+    .option("--value <amount>", "deal value", nonnegativeNumber)
+    .option("--currency <code>", "three-letter currency code")
+    .option("--stage <id>", "stage ID")
+    .option("--contact <id>", "contact ID")
+    .option("--company <id>", "company ID")
+    .option("--notes <text>", "notes")
+    .action((appId, title, options) => {
+    const { stage, contact, company, ...rest } = options;
+    return call("create_deal", { appId, title, ...rest, ...(stage ? { stageId: stage } : {}), ...(contact ? { contactId: contact } : {}), ...(company ? { companyId: company } : {}) });
+});
+program.command("deal:move <deal-id> <stage-id>").description("Move a deal to another stage")
+    .action((dealId, stageId) => call("move_deal", { dealId, stageId }));
+program.command("activity:log <app-id> <deal-id> <body>").description("Add a note, call, email, or meeting to a deal")
+    .option("--kind <kind>", "note, call, email, or meeting", "note")
+    .action((appId, dealId, body, options) => {
+    if (!["note", "call", "email", "meeting"].includes(options.kind))
+        throw new Error("Kind must be note, call, email, or meeting");
+    return call("log_activity", { appId, dealId, body, kind: options.kind });
+});
+program.command("tools").description("List the live IndieCRM API tools").action(async () => {
+    const client = await connect();
+    try {
+        print((await client.listTools()).tools.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })));
+    }
+    finally {
+        await client.close();
+    }
+});
+program.command("call <tool>").description("Call an IndieCRM API tool with JSON arguments")
+    .requiredOption("--input <json>", "JSON object matching the tool schema")
+    .action((tool, options) => {
+    const input = JSON.parse(options.input);
+    if (!input || Array.isArray(input) || typeof input !== "object")
+        throw new Error("Input must be a JSON object");
+    return call(tool, input);
+});
+program.parseAsync(process.argv).catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "indiecrm-cli",
+  "version": "0.1.0",
+  "description": "Command-line access to IndieCRM workspaces, contacts, companies, and deals",
+  "author": "Daniel Sinewe <hello@danielsinewe.com>",
+  "type": "module",
+  "bin": { "indiecrm": "dist/indiecrm-cli.js" },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.indiecrm.json",
+    "check": "tsc --noEmit -p tsconfig.indiecrm.json",
+    "test": "npm run build && node --test tests/indiecrm-cli.test.mjs"
+  },
+  "engines": { "node": ">=22.12.0" },
+  "publishConfig": { "access": "public" },
+  "keywords": ["indiecrm", "cli", "crm", "sales", "mcp"],
+  "homepage": "https://indiecrm.app",
+  "repository": { "type": "git", "url": "git+https://github.com/danielsinewe/indiecrm-cli.git" },
+  "bugs": { "url": "https://github.com/danielsinewe/indiecrm-cli/issues" },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/client": "^2.1.0",
+    "commander": "^14.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  }
+}