Repository avatar
Other Tools
v1.0.5
active

agent

io.github.businesskitai/agent

Universal BusinessKit agent workspace: POS, invoicing, restock, CRM, and website publishing.

Documentation

BusinessKit Agent

The universal autonomous agent workspace for BusinessKit. Operate, manage, and automate your entire business from any AI assistant or coding agent—including Claude Code, Cursor, Antigravity, VS Code Copilot, and Gemini CLI.


What is BusinessKit Agent?

BusinessKit Agent connects your favorite AI agent directly to your local BusinessKit desktop app through the Model Context Protocol (MCP).

Instead of switching back and forth between apps and forms, your AI assistant can execute real business operations on your behalf:

  • Billing & POS: Create walk-in POS receipts, parse handwritten bills, and draft formal customer invoices.
  • Inventory & Purchasing: Scan supplier purchase invoices, automatically restock items, update moving average cost, and adjust inventory.
  • Website & Landing Pages: Assemble responsive landing pages with native modular sections or create bespoke custom components.
  • Docs & Publishing: Write and publish technical documentation, guides, newsletters, and SEO-optimized blog posts.
  • CRM & Contacts: Register and organize clients, suppliers, and leads with tags and contact info.
  • Support Inbox: Triage customer threads, extract 2FA verification codes, and draft email replies.

How It Works

AI Assistant / IDE
(Claude Code / Cursor / Antigravity / VS Code)
  │
  ├─ Reads Universal Commands & Skills (`commands/` & `skills/`)
  │    └─ Editorial rules, page layouts, accounting workflows
  │
  └─ Calls BusinessKit MCP Server (`businesskit --mcp --profile <id>`)
       │
       └─ Native BusinessKit Engine
            ├─ Automatic double-entry ledger balancing (`fin_journal_entries`)
            ├─ Append-only stock & customer credit ledgers
            ├─ Isolated local profile database
            └─ Zero credential exposure (keys stay in OS Keychain)

All business logic, financial ledger balancing, inventory calculations, and database operations are executed safely inside the native BusinessKit engine. Your database credentials never leak into LLM prompts.


Quick Start

Option A: Install via Agent CLI / Marketplace

Claude Code:

claude plugin add https://github.com/businesskitai/businesskit-agent

Antigravity / Gemini CLI:

agy plugin install https://github.com/businesskitai/businesskit-agent

SuperConsole AI: In SuperConsole, go to Customize → Plugins → Add from URL and paste:

https://github.com/businesskitai/businesskit-agent/blob/main/.superconsole-plugin/plugin.json

Option B: Run Universal Setup (All IDEs & Agents)

From inside this directory:

./bin/businesskit.js
# or: npx @businesskit/agent
# or: npm run setup

The setup script automatically:

  1. Detects your installed BusinessKit app (/Applications/BusinessKit.app on macOS, or build binary).
  2. Connects to your active organization profile.
  3. Configures your agent environment:
    • Claude Code: generates .mcp.json and .claude/commands
    • Cursor: generates .cursor/mcp.json and .cursorrules
    • Antigravity / Gemini CLI: registers via agy mcp add / .gemini/mcp_config.json
    • VS Code: generates .vscode/mcp.json

Using With Your Agent

Claude Code

Open your terminal in this repository and start Claude:

claude

Type any slash command directly:

/write-docs "Getting Started"
/create-page "About Us"
/create-new-bill 5 Box Tellzy 40 Tab @ ₹1258.83 -15%

Antigravity & Gemini CLI

Install the plugin directly:

agy plugin install https://github.com/businesskitai/businesskit-agent

Antigravity automatically discovers plugin.json, rules/AGENTS.md, mcp_config.json, and skills/. You can use natural language or slash triggers:

  • "Draft a customer invoice for Acme Corp with 10 units of consulting"
  • /write-docs "Pages Architecture"
  • "Restock items from this supplier bill"

Cursor

Open this folder in Cursor (cursor .). Cursor detects .cursorrules and .cursor/mcp.json. Use natural language or slash commands with the agent:

  • "Create a landing page for our Black Friday Sale with hero, features, and pricing"
  • "Check stock levels for Tellzy 40"

SuperConsole AI

In SuperConsole:

  1. Navigate to Customize → Plugins.
  2. Click Add from GitHub URL.
  3. Paste:
    https://github.com/businesskitai/businesskit-agent/blob/main/.superconsole-plugin/plugin.json
    
  4. Click Install. All skills and commands are activated.

Universal Commands (commands/)

All 23 universal commands match the BusinessKit in-app commands 1:1:

DomainCommandDescription
Docs & CMS/write-docsWrite structured documentation or knowledge base articles (cat_32)
/write-blogDraft or publish a blog post with clean TipTap HTML (cat_35)
/write-guideStep-by-step how-to guide with prerequisites and FAQs (cat_36)
/write-newsletterConversational email newsletter issue with sections and CTA (cat_20)
/list-contentList published and draft articles across hubs
/update-contentEdit body HTML, metadata, collection, or publish status
/seo-auditAudit SEO titles, meta descriptions, and keywords
Pages & Web/create-pageAssemble a complete landing page using native visual sections
/update-pageUpdate sections, copy, or settings on an existing page
/publish-pageToggle page live/published status
/list-pagesList all website pages and publication statuses
/create-componentGenerate a bespoke custom component in user_components
/list-componentsList custom components stored in user_components
Shop & POS/create-new-billImmediate POS billing receipt, natural language or handwritten bill
/create-invoiceDraft a formal itemized B2B customer invoice
/send-invoiceSend customer invoice via email and generate payment link
/update-priceUpdate retail selling price, cost, or discount floor
Inventory/add-inventory-from-invoiceScan purchase invoice to restock items and post accounting
/check-stockQuery on-hand inventory levels and low-stock alerts
/adjust-stockRecord damage, shrinkage, or audit count variances
CRM/add-contactRegister a new client, lead, or supplier in CRM
/update-contactUpdate contact information, company, or tags
System/capabilitiesDiscover active modules, profile settings, and tools

Workflow Skills (skills/)


Operating Principles

  1. Native Engine Execution: All operations run through verified BusinessKit tools with atomic database transactions.
  2. Drafts First: External communications, customer invoices, and emails are prepared as drafts for human review before transmission.
  3. Structured Outputs: All deliverables, exports, and generated files are organized in ./output/.
NPM
@businesskit/agent
Install Command
npm install @businesskit/agent