@ktmcp-cli/billingo 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +4 -5
  3. package/banner.svg +25 -0
  4. package/bin/billingo.js +3 -0
  5. package/package.json +1 -1
  6. package/src/lib/welcome.js +47 -0
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2024 KTMCP
3
+ Copyright (c) 2026 Tom Granot
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -1,12 +1,11 @@
1
- # Billingo CLI
2
-
3
- <p align="center">
4
- <img src="banner.png" alt="KTMCP Banner" width="100%">
5
- </p>
1
+ ![Banner](https://raw.githubusercontent.com/ktmcp-cli/billingo/main/banner.svg)
6
2
 
3
+ # Billingo CLI
7
4
 
8
5
  Production-ready command-line interface for the [Billingo API v3](https://www.billingo.hu/) - Hungarian invoicing and billing automation.
9
6
 
7
+ > **⚠️ Unofficial CLI** - This tool is not officially sponsored, endorsed, or maintained by Billingo. It is an independent project built on the public Billingo API. API documentation: https://www.billingo.hu/api-docs
8
+
10
9
  ## Features
11
10
 
12
11
  - Complete coverage of Billingo API v3 endpoints
package/banner.svg ADDED
@@ -0,0 +1,25 @@
1
+ <svg width="1200" height="300" xmlns="http://www.w3.org/2000/svg">
2
+ <defs>
3
+ <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
4
+ <stop offset="0%" style="stop-color:#0a0a0a;stop-opacity:1" />
5
+ <stop offset="100%" style="stop-color:#1a1a1a;stop-opacity:1" />
6
+ </linearGradient>
7
+ </defs>
8
+
9
+ <rect width="1200" height="300" fill="url(#bg)"/>
10
+ <rect x="0" y="0" width="8" height="300" fill="#00ff7f"/>
11
+
12
+ <text x="60" y="100" font-family="system-ui, -apple-system, sans-serif" font-size="72" font-weight="800" fill="#ffffff">Billingo CLI</text>
13
+ <text x="60" y="150" font-family="system-ui, -apple-system, sans-serif" font-size="28" fill="#888888">Hungarian invoicing &amp; billing automation</text>
14
+
15
+ <rect x="60" y="190" width="600" height="60" rx="8" fill="#1e1e1e"/>
16
+ <text x="90" y="230" font-family="monospace" font-size="20" fill="#00ff7f">npm install -g @ktmcp-cli/billingo</text>
17
+
18
+ <!-- Terminal window badge -->
19
+ <rect x="980" y="100" width="180" height="100" rx="4" fill="#0a0e0f" stroke="#00ff7f" stroke-width="2"/>
20
+ <circle cx="995" cy="115" r="3" fill="#ff5f56"/>
21
+ <circle cx="1010" cy="115" r="3" fill="#ffbd2e"/>
22
+ <circle cx="1025" cy="115" r="3" fill="#27c93f"/>
23
+ <text x="1070" y="150" font-family="monospace" font-size="14" fill="#8b9d9f" text-anchor="middle">$ kill -9</text>
24
+ <text x="1070" y="180" font-family="monospace" font-size="24" font-weight="900" fill="#00ff7f" text-anchor="middle">MCP</text>
25
+ </svg>
package/bin/billingo.js CHANGED
@@ -1,5 +1,8 @@
1
1
  #!/usr/bin/env node
2
2
 
3
+ const { showWelcomeMessage } = require('../src/lib/welcome');
4
+ showWelcomeMessage('billingo');
5
+
3
6
  /**
4
7
  * Billingo CLI - Main Entry Point
5
8
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ktmcp-cli/billingo",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "Production-ready CLI for Billingo API v3 - Hungarian invoicing and billing",
5
5
  "type": "module",
6
6
  "main": "src/index.js",
package/src/lib/welcome.js ADDED
@@ -0,0 +1,47 @@
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+ const os = require('os');
4
+
5
+ function showWelcomeMessage(cliName) {
6
+ const configDir = path.join(os.homedir(), `.${cliName}`);
7
+ const welcomeFile = path.join(configDir, '.welcome-shown');
8
+
9
+ // Check if welcome was already shown
10
+ if (fs.existsSync(welcomeFile)) {
11
+ return; // Already shown
12
+ }
13
+
14
+ // Show welcome message
15
+ console.log('\n╔════════════════════════════════════════════════════════════╗');
16
+ console.log('║ ║');
17
+ console.log('║ 👋 Welcome to the Kill The MCP Project! ║');
18
+ console.log('║ ║');
19
+ console.log('║ This CLI is part of KTMCP - a project that generates ║');
20
+ console.log('║ production-ready command-line tools for APIs. ║');
21
+ console.log('║ ║');
22
+ console.log('║ 🎯 Why CLI over MCP? ║');
23
+ console.log('║ • Faster: Direct API calls, no server overhead ║');
24
+ console.log('║ • Cheaper: No tokens, no server costs ║');
25
+ console.log('║ • Simpler: Standard Unix tools, pipe & compose ║');
26
+ console.log('║ • Deterministic: Same input = same output ║');
27
+ console.log('║ ║');
28
+ console.log('║ 🤖 Perfect for AI Agents! ║');
29
+ console.log('║ Agents can use these CLIs directly via bash commands ║');
30
+ console.log('║ without needing MCP server setup. ║');
31
+ console.log('║ ║');
32
+ console.log('║ 📚 Learn more: https://killthemcp.com ║');
33
+ console.log('║ ║');
34
+ console.log('╚════════════════════════════════════════════════════════════╝\n');
35
+
36
+ // Create config dir and mark as shown
37
+ try {
38
+ if (!fs.existsSync(configDir)) {
39
+ fs.mkdirSync(configDir, { recursive: true });
40
+ }
41
+ fs.writeFileSync(welcomeFile, new Date().toISOString());
42
+ } catch (err) {
43
+ // Silently fail if can't create file
44
+ }
45
+ }
46
+
47
+ module.exports = { showWelcomeMessage };