@maximoai/maximo-syntax-cli 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+<p align="center">
+  <a href="https://maximoai.co/syntax">
+    <img src="https://maximoai.co/maximo-syntax-cli-transparent.png" alt="Maximo Syntax CLI logo">
+  </a>
+</p>
+<p align="center">Build, ship, and iterate from your terminal. Maximo Syntax CLI is a powerful AI-powered command-line interface that brings together advanced LLM integration with a lightning-fast developer experience.</p>
+<p align="center">
+  <a href="https://maximoai.co/syntax"><img alt="Website" src="https://img.shields.io/badge/Website-maximoai.co%2Fsyntax-021027?style=flat-square&logo=google-chrome&logoColor=white" /></a>
+  <a href="https://github.com/maximoai-co/maximo-syntax-cli"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-maximoai--co%2Fmaximo--syntax--cli-021027?style=flat-square&logo=github&logoColor=white" /></a>
+</p>
+
+# Maximo Syntax CLI
+
+Maximo Syntax CLI is a powerful AI-powered command-line interface that enables you to work with any LLM — GPT-4o, DeepSeek, Gemini, Llama, Mistral, or any model that speaks the OpenAI chat completions API.
+
+All the tools you need work right from your terminal — bash execution, file read/write/edit, grep, glob, agents, tasks, MCP — all powered by whatever model you choose.
+
+---
+
+## Install
+
+### Option A: npm (recommended)
+
+```bash
+npm install -g @maximoai/maximo-syntax-cli
+```
+
+### Option B: From source (requires Bun)
+
+```bash
+# Clone from maximoai
+git clone https://github.com/maximoai-co/maximo-syntax-cli.git
+cd maximo-syntax-cli
+
+# Install dependencies
+bun install
+
+# Build
+bun run build
+
+# Link globally (optional)
+npm link
+```
+
+### Option C: Run directly with Bun (no build step)
+
+```bash
+git clone https://github.com/maximoai-co/maximo-syntax-cli.git
+cd maximo-syntax-cli
+bun install
+bun run dev
+```
+
+---
+
+## Quick Start
+
+### 1. Set up Maximo AI (Recommended)
+
+Maximo Syntax CLI uses Maximo AI as the default provider. Get your API key from [Maximo AI](https://maximoai.co/platform) and set the following environment variables:
+
+```bash
+export CLAUDE_CODE_USE_OPENAI=1
+export OPENAI_API_KEY=your-maximo-api-key
+export OPENAI_BASE_URL=https://api.maximoai.co/v1
+export OPENAI_MODEL=maximo-pandora-3.6-nano
+```
+
+Or create a `.env` file in your project directory:
+
+```
+CLAUDE_CODE_USE_OPENAI=1
+OPENAI_API_KEY=your-maximo-api-key
+OPENAI_BASE_URL=https://api.maximoai.co/v1
+OPENAI_MODEL=maximo-pandora-3.6-nano
+```
+
+### 2. Run Maximo Syntax CLI
+
+```bash
+maximo-syntax-cli
+```
+
+---
+
+## Alternative Providers
+
+### OpenAI / Any OpenAI-compatible provider (GPT-4o, DeepSeek, Ollama, Groq)
+
+```bash
+export CLAUDE_CODE_USE_OPENAI=1
+export OPENAI_API_KEY=sk-...
+export OPENAI_MODEL=gpt-4o
+```
+
+### Google Gemini (free key at https://aistudio.google.com/apikey)
+
+```bash
+export CLAUDE_CODE_USE_GEMINI=1
+export GEMINI_API_KEY=your-key
+```
+
+### Amazon Bedrock
+
+See documentation: https://code.claude.com/docs/en/amazon-bedrock
+
+### Microsoft Foundry
+
+See documentation: https://code.claude.com/docs/en/microsoft-foundry
+
+### Vertex AI
+
+See documentation: https://code.claude.com/docs/en/google-vertex-ai
+
+---
+
+## Documentation
+
+- [Maximo AI Documentation](https://maximoai.co/syntax)
+- [GitHub Repository](https://github.com/maximoai-co/maximo-syntax-cli)

package/bin/import-specifier.mjs

@@ -0,0 +1,7 @@
+import { join } from 'path'
+import { pathToFileURL } from 'url'
+
+export function getDistImportSpecifier(baseDir) {
+  const distPath = join(baseDir, '..', 'dist', 'cli.mjs')
+  return pathToFileURL(distPath).href
+}

package/bin/import-specifier.test.mjs

@@ -0,0 +1,13 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { getDistImportSpecifier } from './import-specifier.mjs'
+
+test('builds a file URL import specifier for dist/cli.mjs', () => {
+  const specifier = getDistImportSpecifier('C:\\repo\\bin')
+
+  assert.equal(
+    specifier,
+    'file:///C:/repo/dist/cli.mjs',
+  )
+})

package/bin/maximo-syntax-cli

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+/**
+ * Maximo Syntax CLI — Maximo Syntax with any LLM, powered by Maximo AI
+ *
+ * If dist/cli.mjs exists (built), run that.
+ * Otherwise, tell the user to build first or use `bun run dev`.
+ */
+
+import { existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath, pathToFileURL } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const distPath = join(__dirname, "..", "dist", "cli.mjs");
+
+if (existsSync(distPath)) {
+  await import(pathToFileURL(distPath).href);
+} else {
+  console.error(`
+  maximo-syntax-cli: dist/cli.mjs not found.
+
+  Build first:
+    bun run build
+
+  Or run directly with Bun:
+    bun run dev
+
+  See README.md for setup instructions.
+`);
+  process.exit(1);
+}