Skip to content

0.2.1

Choose a tag to compare

View all tags
@madeburo madeburo released this 11 Mar 18:04
· 7 commits to main since this release
v0.2.1
65bee95

Added

geo-ai-cli (new package — v0.1.0)

A new standalone CLI package for the GEO AI ecosystem.

npm install -g geo-ai-cli
# or per-project:
npm install --save-dev geo-ai-cli

Commands:

  • geo-ai init — scaffolds a geo-ai.config.ts starter file in the current directory with placeholder values for siteName, siteUrl, siteDescription, crawlers, and a provider section. Exits safely if a config already exists.
  • geo-ai generate — loads config (auto-discovers geo-ai.config.ts → .js → .json), calls geo-ai-core to generate content, and writes llms.txt + llms-full.txt to ./public (or --out <path>). Creates the output directory if missing.
  • geo-ai validate — checks that llms.txt and llms-full.txt are present and have valid content. Supports local files (--path <dir>) and remote URLs (--url <url>). Reports pass / warn / fail / not_found per file with actionable recommendations. Exits 1 on any fail or not_found.
  • geo-ai inspect — previews your config: site name, URL, description, crawler rules, output directory, and resource sections with item counts. With --url, fetches and displays remote llms.txt / llms-full.txt content.

Flags:

  • --config <path> — override config file path
  • --out <path> — override output directory (generate)
  • --path <dir> — local directory to validate
  • --url <url> — remote base URL for validate/inspect
  • --help / -h — show help (global or per-command)
  • --version / -v — show version

Error handling:

  • Typed error classes with exit codes: ConfigNotFoundError, ConfigParseError, ConfigValidationError, FsWriteError, NetworkError → exit 1; InternalError → exit 2
  • DEBUG=geo-ai env var prints stack traces to stderr
  • No raw stack traces on stdout

Technical:

  • Zero runtime dependencies beyond geo-ai-core
  • ESM-only build (dist/cli.mjs) with #!/usr/bin/env node shebang
  • Programmatic API via dist/index.mjs with full TypeScript declarations
  • Node.js >= 20 required

Docs

  • Added geo-ai-cli to ecosystem tables and installation sections in geo-ai-core and root README
  • Added description field to geo-ai-core and geo-ai-next package.json for npm listing
  • Added README.md and CHANGELOG.md to files in all three packages
  • geo-ai-core/README.md: new Ecosystem section with package comparison table
Assets 2
Loading