{"_id":"@bramatom/bookgenai","_rev":"5-0f6342def2d8d16b4278183a2b6463ed","name":"@bramatom/bookgenai","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"@bramatom/bookgenai","version":"1.0.0","keywords":["ai","writing","book","cli","assistant","openrouter","typescript"],"author":{"name":"BookGenAI Team"},"license":"MIT","_id":"@bramatom/bookgenai@1.0.0","maintainers":[{"name":"bramatom","email":"bramatom@gmail.com"}],"homepage":"https://github.com/marco-private/bookgenai#readme","bugs":{"url":"https://github.com/marco-private/bookgenai/issues"},"bin":{"bga":"dist/cli.js","bookgenai":"dist/cli.js"},"dist":{"shasum":"7019c7aa8ff0c13e683daeecbdd2c5b84caa10c4","tarball":"https://registry.npmjs.org/@bramatom/bookgenai/-/bookgenai-1.0.0.tgz","fileCount":63,"integrity":"sha512-pw3+Csvj+1dcAvCJJssy/pR6NAS/otKQdoJg38enoS5lHa1nWM0F3t9/FiC46DzplV2VD4wPkwJHNadeBmrBOw==","signatures":[{"sig":"MEUCIQDk5RhlKMRXJDaEcZrpagkSUbsJIIwPD170LvRjD+4SlAIgZ7rGxE4F7TeQF2Od8A7I3IVjMGTaZaUqeFOt68qpNko=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":311788},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"166c391cd9a9a58cc424d4b6dd2f600ad778e67d","scripts":{"dev":"tsx src/cli.ts","lint":"eslint src --ext .ts,.js","test":"vitest","build":"tsc","clean":"rimraf dist","start":"node dist/cli.js","format":"prettier --write src/**/*.{ts,js,json}","test:ui":"vitest --ui","lint:fix":"eslint src --ext .ts,.js --fix","build:watch":"tsc --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"bramatom","email":"bramatom@gmail.com"},"repository":{"url":"git+https://github.com/marco-private/bookgenai.git","type":"git"},"_npmVersion":"10.9.3","description":"AI-powered book writing assistant CLI inspired by Claude Code, Cursor AI, and Windsurf Agent","directories":{},"_nodeVersion":"22.18.0","dependencies":{"ora":"^8.1.1","zod":"^3.24.1","conf":"^13.0.1","path":"^0.12.7","yaml":"^2.6.1","chalk":"^5.3.0","fs-extra":"^11.2.0","inquirer":"^9.3.7","commander":"^12.1.0","node-fetch":"^3.3.2","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.9","@inquirer/prompts":"^6.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","eslint":"^9.17.0","rimraf":"^6.0.1","vitest":"^2.1.8","prettier":"^3.4.2","typescript":"^5.7.2","@types/node":"^22.10.2","@types/fs-extra":"^11.0.4","@typescript-eslint/parser":"^8.18.2","@typescript-eslint/eslint-plugin":"^8.18.2"},"_npmOperationalInternal":{"tmp":"tmp/bookgenai_1.0.0_1756043383702_0.9678054479948921","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bramatom/bookgenai","version":"1.0.1","keywords":["ai","writing","book","creative","cli","openrouter","novel","author"],"author":{"name":"Marco","email":"marco@example.com"},"license":"MIT","_id":"@bramatom/bookgenai@1.0.1","maintainers":[{"name":"bramatom","email":"bramatom@gmail.com"}],"homepage":"https://github.com/bramatom/bookgenai#readme","bugs":{"url":"https://github.com/bramatom/bookgenai/issues"},"bin":{"libro":"dist/cli.js","bookgenai":"dist/cli.js"},"dist":{"shasum":"a9254f00e83630e7e30c5c85489b4861a021ed8d","tarball":"https://registry.npmjs.org/@bramatom/bookgenai/-/bookgenai-1.0.1.tgz","fileCount":106,"integrity":"sha512-3RKtitoPoAA7dh8HewGJmVnBTixMPRcfsNpcc/W0oTjTKtgZ2KHiRPydU5fgXq16CHlETvr+A2908pHkuPFFfg==","signatures":[{"sig":"MEUCIQDW5Ud6Cv5+8qlZG6W8hOGk/AJu47iXYpdigclybGVANAIgbjZhSZwFUKwI7pjDdeeGSbnJaYoNehURONhYjBrqmzg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":513718},"main":"dist/index.js","engines":{"node":">=16.0.0"},"gitHead":"c2b8fc041e3b9d4c14d1ae84629ebd0a281369bc","scripts":{"dev":"tsx src/cli.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc && chmod +x dist/cli.js","clean":"rm -rf dist","start":"node dist/cli.js","format":"prettier --write src/**/*.ts","package":"npm run clean && npm run build && npm pack","lint:fix":"eslint src/**/*.ts --fix","typecheck":"tsc --noEmit","test:watch":"jest --watch","test:coverage":"jest --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"bramatom","email":"bramatom@gmail.com"},"repository":{"url":"git+https://github.com/bramatom/bookgenai.git","type":"git"},"_npmVersion":"10.9.3","description":"An intelligent CLI for AI-powered book writing and creative assistance","directories":{},"_nodeVersion":"22.18.0","dependencies":{"ora":"^7.0.1","zod":"^3.22.4","docx":"^9.5.1","glob":"^10.3.10","axios":"^1.6.2","boxen":"^7.1.1","chalk":"^5.3.0","jspdf":"^3.0.1","dotenv":"^16.3.1","figlet":"^1.7.0","semver":"^7.5.4","js-yaml":"^4.1.0","p-queue":"^8.0.1","p-retry":"^6.2.0","fs-extra":"^11.2.0","inquirer":"^9.2.12","commander":"^11.1.0","officegen":"^0.6.5","cli-table3":"^0.6.3","node-cache":"^5.1.2","cosmiconfig":"^8.3.6","html2canvas":"^1.4.1","markdown-it":"^13.0.2","puppeteer-core":"^24.17.0","update-notifier":"^7.0.0"},"preferGlobal":true,"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.6.2","jest":"^29.7.0","eslint":"^8.55.0","ts-jest":"^29.1.1","prettier":"^3.1.1","typescript":"^5.3.3","@types/jest":"^29.5.8","@types/node":"^20.10.4","@types/figlet":"^1.5.8","@types/semver":"^7.5.6","@types/js-yaml":"^4.0.9","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7","@types/markdown-it":"^13.0.7","@types/update-notifier":"^6.0.8","eslint-config-prettier":"^9.1.0","eslint-plugin-prettier":"^5.0.1","@typescript-eslint/parser":"^6.13.2","@typescript-eslint/eslint-plugin":"^6.13.2"},"_npmOperationalInternal":{"tmp":"tmp/bookgenai_1.0.1_1756055072766_0.8953581370675174","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@bramatom/bookgenai","version":"1.0.2","keywords":["ai","writing","book","creative","cli","openrouter","novel","author"],"author":{"name":"Marco","email":"marco@example.com"},"license":"MIT","_id":"@bramatom/bookgenai@1.0.2","maintainers":[{"name":"bramatom","email":"bramatom@gmail.com"}],"homepage":"https://github.com/bramatom/bookgenai#readme","bugs":{"url":"https://github.com/bramatom/bookgenai/issues"},"bin":{"libro":"dist/cli.js","bookgenai":"dist/cli.js"},"dist":{"shasum":"2695a9c832a343ed951b46605170aa8fe65f730c","tarball":"https://registry.npmjs.org/@bramatom/bookgenai/-/bookgenai-1.0.2.tgz","fileCount":106,"integrity":"sha512-caeB4pomeCpw0Ll+vElX0/5aMSKa0uEIzl1ZgyQf/i3fZ2k56Utxh3cxpBAP9s6gCIqxTa1pHOFxhpnHwSGGEQ==","signatures":[{"sig":"MEUCIQCv2Ue//HFM6oqe5rr21X1arB3jZv0QlQcfR6Fd/mqCHgIgAi2W6VNwuzAShRjgu2qNJ8BkvFxztQ/fgES6qcEUR8k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":513492},"main":"dist/index.js","engines":{"node":">=16.0.0"},"gitHead":"fb614355d4d73cc5b9a4490917c8b386c8c21bba","scripts":{"dev":"tsx src/cli.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc && chmod +x dist/cli.js","clean":"rm -rf dist","start":"node dist/cli.js","format":"prettier --write src/**/*.ts","package":"npm run clean && npm run build && npm pack","lint:fix":"eslint src/**/*.ts --fix","typecheck":"tsc --noEmit","test:watch":"jest --watch","test:coverage":"jest --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"bramatom","email":"bramatom@gmail.com"},"repository":{"url":"git+https://github.com/bramatom/bookgenai.git","type":"git"},"_npmVersion":"10.9.3","description":"An intelligent CLI for AI-powered book writing and creative assistance","directories":{},"_nodeVersion":"22.18.0","dependencies":{"ora":"^7.0.1","zod":"^3.22.4","docx":"^9.5.1","glob":"^10.3.10","axios":"^1.6.2","boxen":"^7.1.1","chalk":"^5.3.0","jspdf":"^3.0.1","dotenv":"^16.3.1","figlet":"^1.7.0","semver":"^7.5.4","js-yaml":"^4.1.0","p-queue":"^8.0.1","p-retry":"^6.2.0","fs-extra":"^11.2.0","inquirer":"^9.2.12","commander":"^11.1.0","officegen":"^0.6.5","cli-table3":"^0.6.3","node-cache":"^5.1.2","cosmiconfig":"^8.3.6","html2canvas":"^1.4.1","markdown-it":"^13.0.2","puppeteer-core":"^24.17.0","update-notifier":"^7.0.0"},"preferGlobal":true,"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.6.2","jest":"^29.7.0","eslint":"^8.55.0","ts-jest":"^29.1.1","prettier":"^3.1.1","typescript":"^5.3.3","@types/jest":"^29.5.8","@types/node":"^20.10.4","@types/figlet":"^1.5.8","@types/semver":"^7.5.6","@types/js-yaml":"^4.0.9","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7","@types/markdown-it":"^13.0.7","@types/update-notifier":"^6.0.8","eslint-config-prettier":"^9.1.0","eslint-plugin-prettier":"^5.0.1","@typescript-eslint/parser":"^6.13.2","@typescript-eslint/eslint-plugin":"^6.13.2"},"_npmOperationalInternal":{"tmp":"tmp/bookgenai_1.0.2_1756101455134_0.1685662860132655","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@bramatom/bookgenai","version":"1.1.0","keywords":["ai","writing","book","creative","cli","openrouter","novel","author"],"author":{"name":"Marco","email":"marco@example.com"},"license":"MIT","_id":"@bramatom/bookgenai@1.1.0","maintainers":[{"name":"bramatom","email":"bramatom@gmail.com"}],"homepage":"https://github.com/bramatom/bookgenai#readme","bugs":{"url":"https://github.com/bramatom/bookgenai/issues"},"bin":{"libro":"dist/cli.js","bookgenai":"dist/cli.js"},"dist":{"shasum":"511568aafea5a1835fe42b439f5c4644adb41a1a","tarball":"https://registry.npmjs.org/@bramatom/bookgenai/-/bookgenai-1.1.0.tgz","fileCount":106,"integrity":"sha512-84kcoF/GTNiZRYtP8zPvW3E3385HvJZIkNwgEYEEVMa7uYQA2zZjzpF1M/reV84u8zvjZTh/B7e0t+wa1gow0A==","signatures":[{"sig":"MEYCIQDB5uqZEIzH2l/JSpRkLIkga3U+EzjeJHZXw5KN2zOjYAIhAMuXhzq1zzVjGgYm+S3m0yzdjTgYrGh+ckLFCc0CUzgO","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":577379},"main":"dist/index.js","engines":{"node":">=16.0.0"},"gitHead":"9f902e22c2103ffd1b07c60d16e5bd15e615f38e","scripts":{"dev":"tsx src/cli.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc && chmod +x dist/cli.js","clean":"rm -rf dist","start":"node dist/cli.js","format":"prettier --write src/**/*.ts","package":"npm run clean && npm run build && npm pack","lint:fix":"eslint src/**/*.ts --fix","typecheck":"tsc --noEmit","test:watch":"jest --watch","test:coverage":"jest --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"bramatom","email":"bramatom@gmail.com"},"repository":{"url":"git+https://github.com/bramatom/bookgenai.git","type":"git"},"_npmVersion":"10.9.3","description":"An intelligent CLI for AI-powered book writing and creative assistance","directories":{},"_nodeVersion":"22.18.0","dependencies":{"ora":"^7.0.1","zod":"^3.22.4","docx":"^9.5.1","glob":"^10.3.10","axios":"^1.6.2","boxen":"^7.1.1","chalk":"^5.3.0","jspdf":"^3.0.1","dotenv":"^16.3.1","figlet":"^1.7.0","semver":"^7.5.4","js-yaml":"^4.1.0","p-queue":"^8.0.1","p-retry":"^6.2.0","fs-extra":"^11.2.0","inquirer":"^9.2.12","commander":"^11.1.0","officegen":"^0.6.5","cli-table3":"^0.6.3","node-cache":"^5.1.2","cosmiconfig":"^8.3.6","html2canvas":"^1.4.1","markdown-it":"^13.0.2","puppeteer-core":"^24.17.0","update-notifier":"^7.0.0"},"preferGlobal":true,"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.6.2","jest":"^29.7.0","eslint":"^8.55.0","ts-jest":"^29.1.1","prettier":"^3.1.1","typescript":"^5.3.3","@types/jest":"^29.5.8","@types/node":"^20.10.4","@types/figlet":"^1.5.8","@types/semver":"^7.5.6","@types/js-yaml":"^4.0.9","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7","@types/markdown-it":"^13.0.7","@types/update-notifier":"^6.0.8","eslint-config-prettier":"^9.1.0","eslint-plugin-prettier":"^5.0.1","@typescript-eslint/parser":"^6.13.2","@typescript-eslint/eslint-plugin":"^6.13.2"},"_npmOperationalInternal":{"tmp":"tmp/bookgenai_1.1.0_1756104465190_0.2545685909131352","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@bramatom/bookgenai","version":"1.1.1","description":"An intelligent CLI for AI-powered book writing and creative assistance","publishConfig":{"access":"public"},"keywords":["ai","writing","book","creative","cli","openrouter","novel","author"],"author":{"name":"Marco","email":"marco@example.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/bramatom/bookgenai.git"},"homepage":"https://github.com/bramatom/bookgenai#readme","bugs":{"url":"https://github.com/bramatom/bookgenai/issues"},"main":"dist/index.js","bin":{"bookgenai":"dist/cli.js","libro":"dist/cli.js"},"engines":{"node":">=16.0.0"},"scripts":{"dev":"tsx src/cli.ts","build":"tsc && chmod +x dist/cli.js","start":"node dist/cli.js","test":"jest","test:watch":"jest --watch","test:coverage":"jest --coverage","lint":"eslint src/**/*.ts","lint:fix":"eslint src/**/*.ts --fix","format":"prettier --write src/**/*.ts","clean":"rm -rf dist","package":"npm run clean && npm run build && npm pack","prepublishOnly":"npm run build","typecheck":"tsc --noEmit"},"dependencies":{"axios":"^1.6.2","boxen":"^7.1.1","chalk":"^5.3.0","cli-table3":"^0.6.3","commander":"^11.1.0","cosmiconfig":"^8.3.6","docx":"^9.5.1","dotenv":"^16.3.1","figlet":"^1.7.0","fs-extra":"^11.2.0","glob":"^10.3.10","html2canvas":"^1.4.1","inquirer":"^9.2.12","js-yaml":"^4.1.0","jspdf":"^3.0.1","markdown-it":"^13.0.2","node-cache":"^5.1.2","officegen":"^0.6.5","ora":"^7.0.1","p-queue":"^8.0.1","p-retry":"^6.2.0","puppeteer-core":"^24.17.0","semver":"^7.5.4","update-notifier":"^7.0.0","zod":"^3.22.4"},"devDependencies":{"@types/figlet":"^1.5.8","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7","@types/jest":"^29.5.8","@types/js-yaml":"^4.0.9","@types/markdown-it":"^13.0.7","@types/node":"^20.10.4","@types/semver":"^7.5.6","@types/update-notifier":"^6.0.8","@typescript-eslint/eslint-plugin":"^6.13.2","@typescript-eslint/parser":"^6.13.2","eslint":"^8.55.0","eslint-config-prettier":"^9.1.0","eslint-plugin-prettier":"^5.0.1","jest":"^29.7.0","prettier":"^3.1.1","ts-jest":"^29.1.1","tsx":"^4.6.2","typescript":"^5.3.3"},"preferGlobal":true,"_id":"@bramatom/bookgenai@1.1.1","gitHead":"68567b7269f5fc3f4cd464f8a8ef61d8054615c8","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-JCS/4oE/W1MWrrUmxv0ikGJvIEnb3yuIYfyKCwn2HwiRT6EU8ZmEpOzMj49uorbFTtiiLo1UQfGi29Rd7zUfXA==","shasum":"4298300bf06f35a693aa54d92dca68843591e3a2","tarball":"https://registry.npmjs.org/@bramatom/bookgenai/-/bookgenai-1.1.1.tgz","fileCount":106,"unpackedSize":577561,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHFS8CNXj1spILnVrizOJPdyq0muLkqbjAsOmcDaA8IdAiEAr4kUVV4WX/ReqCczhVX58zh7d671/MgZzD2hIgi70nE="}]},"_npmUser":{"name":"bramatom","email":"bramatom@gmail.com"},"directories":{},"maintainers":[{"name":"bramatom","email":"bramatom@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bookgenai_1.1.1_1756109643426_0.8122917736949398"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-24T13:49:43.608Z","modified":"2025-08-25T08:14:03.821Z","1.0.0":"2025-08-24T13:49:43.901Z","1.0.1":"2025-08-24T17:04:32.982Z","1.0.2":"2025-08-25T05:57:35.329Z","1.1.0":"2025-08-25T06:47:45.379Z","1.1.1":"2025-08-25T08:14:03.636Z"},"bugs":{"url":"https://github.com/bramatom/bookgenai/issues"},"author":{"name":"Marco","email":"marco@example.com"},"license":"MIT","homepage":"https://github.com/bramatom/bookgenai#readme","keywords":["ai","writing","book","creative","cli","openrouter","novel","author"],"repository":{"type":"git","url":"git+https://github.com/bramatom/bookgenai.git"},"description":"An intelligent CLI for AI-powered book writing and creative assistance","maintainers":[{"name":"bramatom","email":"bramatom@gmail.com"}],"readme":"# BookGenAI - AI Book Writing Assistant\n\nAn intelligent command-line interface for creative writing powered by multiple AI models through OpenRouter. BookGenAI (\"Libro\") helps authors plan, structure, and write complete books with specialized tools for outlining, character development, world-building, and content generation.\n\n## Overview\n\nBookGenAI transforms the book writing process by providing an interactive console environment where authors can collaborate with AI to create compelling narratives. Inspired by development tools like Claude Code and Cursor AI, but focused entirely on creative writing workflows.\n\n### Key Features\n\n🎯 **Interactive Writing Tools**\n- Story outline generation and management\n- Character profile creation and development\n- Setting and world-building assistance\n- Chapter drafting with context awareness\n- Text editing and refinement suggestions\n\n🤖 **Multi-Model AI Integration**\n- OpenRouter API integration for model flexibility\n- Support for Claude, GPT-4, and other leading models\n- Per-tool model configuration for optimal results\n- Cost optimization with model-specific assignments\n\n📚 **Professional Document Export**\n- DOCX export with proper heading structure\n- Seamless integration with Google Docs, MS Word, Pages\n- Multiple format support (Markdown, HTML, Plain Text)\n- Automatic table of contents generation\n\n🎨 **Rich Console Interface**\n- Colored output with professional styling\n- Interactive menus and guided workflows\n- Progress indicators for long operations\n- Formatted tables and structured displays\n\n🔧 **Extensible Architecture**\n- Modular tool system for easy expansion\n- Plugin-ready design for custom tools\n- Project-based organization with persistence\n- Global installation for system-wide access\n\n## Quick Start\n\n### Installation\n\n#### From npm (Public)\n\n```bash\n# Install globally from npm\nnpm install -g @bramatom/bookgenai\n\n# Verify installation\nbookgenai --version\nlibro --version  # Italian alias\n```\n\n#### From Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/bramatom/bookgenai.git\ncd bookgenai\n\n# Install dependencies and build\nnpm install\nnpm run build\n\n# Link globally for development\nnpm link\n```\n\nBoth methods provide access to the Italian alias `libro`.\n\n### First Steps\n\n```bash\n# Initialize a new book project\nbookgenai init\n\n# Or use the Italian command\nlibro inizia\n\n# Follow the interactive setup to configure your book\n```\n\n### Basic Workflow\n\n1. **Project Setup**: Create a new book project with metadata\n2. **Outline Creation**: Generate or define your story structure\n3. **Character Development**: Create detailed character profiles\n4. **World Building**: Define settings and locations\n5. **Content Generation**: Write chapters using AI assistance\n6. **Export**: Compile your book into professional formats\n\n## Commands\n\n### Core Commands\n\n```bash\nbookgenai init                    # Initialize new book project\nbookgenai outline                 # Create or update story outline\nbookgenai character create <name> # Create character profiles with AI\nbookgenai character list          # Show all characters with formatting\nbookgenai character relationships # Generate character relationship maps\nbookgenai character arc [name]    # Create character development arcs\nbookgenai setting <location>      # Define locations and world-building\nbookgenai write chapter <n>       # Generate chapter content\nbookgenai edit chapter <n>        # Refine existing chapters\nbookgenai export [format]         # Export completed manuscript\n```\n\n### Italian Commands (Aliases)\n\n```bash\nlibro inizia                      # Initialize project\nlibro scaletta                   # Story outline\nlibro personaggio create <nome>   # Character creation with AI\nlibro personaggio list           # Show all characters\nlibro personaggio relationships  # Character relationship maps\nlibro personaggio arc [nome]     # Character development arcs\nlibro ambientazione <luogo>       # Setting definition\nlibro scrivi capitolo <n>        # Write chapter\nlibro modifica capitolo <n>      # Edit chapter\nlibro esporta [formato]           # Export manuscript\n```\n\n### Configuration\n\nBookGenAI features a comprehensive configuration system with interactive setup wizard, dynamic model selection from OpenRouter, and full Italian localization.\n\n**📖 [Complete Configuration System Documentation](src/cli/commands/README.md)**\n\n```bash\nbookgenai config setup            # Interactive configuration wizard (recommended)\nbookgenai config show             # Display current configuration\nbookgenai config models           # Show available AI models\nbookgenai config validate         # Test configuration and API connectivity\nbookgenai config set <key> <value> # Set specific configuration value\nbookgenai config get <key>        # Get specific configuration value\nbookgenai config reset            # Reset to defaults\n\n# Italian commands\nlibro configurazione configura    # Wizard di configurazione\nlibro configurazione mostra       # Mostra configurazione\nlibro configurazione modelli      # Mostra modelli disponibili\n```\n\n## Project Structure\n\nWhen you initialize a project, BookGenAI creates this structure:\n\n```\nmy-book/\n├── project.json              # Book metadata and configuration\n├── outline.yaml              # Story structure and chapter planning\n├── characters/               # Character profile files (YAML)\n│   ├── elena-rossi.yaml\n│   ├── marco-bianchi.yaml\n│   └── sofia-neri.yaml\n├── settings/                 # Location and world-building\n│   ├── main-location.json\n│   └── secondary-places.json\n├── chapters/                 # Individual chapter files\n│   ├── 01-opening.md\n│   ├── 02-inciting-incident.md\n│   └── ...\n├── exports/                  # Generated documents\n│   ├── my-book.docx\n│   └── my-book.md\n└── .bookgenairc             # Local project preferences\n```\n\n## Writing Tools\n\n### Outline Tool\nCreates structured story outlines with:\n- Chapter-by-chapter breakdowns\n- Plot point identification\n- Pacing and structure analysis\n- Character arc integration\n\n**📖 [Complete Outline Command Documentation](src/cli/commands/README.md)**\n\n### Character Tool\nDevelops rich character profiles including:\n- Personality traits and motivations\n- Background and history\n- Character relationships\n- Growth arcs and development\n- Dialogue voice and style\n\n**📖 [Complete Character Management Documentation](src/utils/README.md)**\n\n### Setting Tool\nBuilds immersive world details:\n- Location descriptions\n- Cultural and social contexts\n- Historical backgrounds\n- Visual and sensory details\n- Consistency tracking\n\n### Draft Writer\nGenerates chapter content with:\n- Context awareness from outline and characters\n- Style consistency maintenance\n- Proper narrative structure\n- Scene description and dialogue\n- Chapter flow and transitions\n\n### Editor Tool\nRefines and improves text through:\n- Grammar and style checking\n- Consistency analysis\n- Tone and voice alignment\n- Structure and pacing suggestions\n- Character voice maintenance\n\n## AI Model Configuration\n\nBookGenAI features a comprehensive AI integration system powered by OpenRouter, providing access to multiple state-of-the-art models with intelligent optimization for different writing tasks.\n\n**📖 [Complete AI Integration Documentation](src/ai/README.md)**\n\n### Default Model Setup\n```bash\n# Set your preferred default model\nbookgenai config model claude-3-opus\n\n# Configure OpenRouter API key\nexport OPENROUTER_API_KEY=\"your-api-key-here\"\n```\n\n### Per-Tool Model Assignment\n```bash\n# Use different models for different tasks\nbookgenai config outline-model gpt-4          # Structural work\nbookgenai config character-model claude-3     # Character development  \nbookgenai config writing-model claude-3-opus  # Creative writing\nbookgenai config editing-model gpt-4          # Text refinement\n```\n\n### Enterprise Features\n- **Automatic Rate Limiting**: Built-in request queuing and throttling\n- **Response Caching**: Intelligent caching with TTL for improved performance\n- **Usage Analytics**: Detailed tracking of tokens, costs, and performance\n- **Error Recovery**: Automatic retry with exponential backoff\n- **Health Monitoring**: Connection testing and service status tracking\n\n### Cost Optimization\n- Use faster/cheaper models for outlining and editing\n- Reserve premium models for creative content generation\n- Monitor token usage with built-in tracking\n- Automatic model fallback for availability\n- Smart caching reduces duplicate API calls\n\n## Export Options\n\nBookGenAI features a comprehensive multi-format export system designed for professional publishing workflows.\n\n**📖 [Complete Export System Documentation](src/export/README.md)**\n\n### DOCX Export (Professional)\n- Advanced typographic formatting with Times New Roman\n- Structured headings (Chapter titles as Heading 1, sections as Heading 2)\n- Automatic table of contents with page numbers\n- Professional title page with metadata\n- Character and setting appendices\n- Page breaks and proper document structure\n- Compatible with MS Word, Google Docs, Apple Pages\n\n### HTML Export (Interactive)\n- Responsive web design for all devices\n- Interactive table of contents with smooth scrolling\n- Reading progress indicator\n- Multiple themes (Default, Elegant, Modern)\n- Print-optimized CSS styles\n- Professional typography with web fonts\n\n### Markdown Export (Structured)\n- YAML front matter with complete metadata\n- Clean, standardized markdown formatting\n- Character and setting appendices\n- Chapter-by-chapter organization\n- Perfect for version control and collaboration\n\n### Plain Text Export (Universal)\n- Elegant ASCII formatting and borders\n- Clean text layout with proper spacing\n- Chapter separators and structured sections\n- Universal compatibility across all systems\n- Optimized for printing and simple distribution\n\n### Advanced Features\n- **Selective Export**: Choose specific chapters to include\n- **Appendices Control**: Optional character and setting sections  \n- **Custom Output Names**: Specify exact file names\n- **Interactive Mode**: Guided configuration with full options\n- **Batch Processing**: Export multiple formats simultaneously\n- **Progress Tracking**: Real-time export progress with spinners\n\n### Usage Examples\n```bash\n# Basic exports\nbookgenai export                    # Default DOCX format\nbookgenai export html              # Interactive HTML\nbookgenai export markdown          # Structured Markdown\nbookgenai export txt               # Plain text\n\n# Advanced options\nbookgenai export docx -o \"MyBook.docx\" --characters --settings\nbookgenai export html --theme elegant --no-toc\nbookgenai export markdown --chapters \"1,3,5\"\n\n# Interactive mode with full configuration\nbookgenai export -i\n\n# Italian commands\nlibro esporta docx\nlibro esporta html --tema elegante\nlibro esporta -i\n```\n\n## Configuration Files\n\n### Global Configuration (~/.bookgenairc.json)\n```json\n{\n  \"defaultModel\": \"claude-3-opus\",\n  \"modelOverrides\": {\n    \"outline\": \"gpt-4\",\n    \"character\": \"claude-3\",\n    \"writing\": \"claude-3-opus\",\n    \"editing\": \"gpt-4\"\n  },\n  \"interface\": {\n    \"theme\": \"dark\",\n    \"language\": \"en\"\n  },\n  \"export\": {\n    \"defaultFormat\": \"docx\",\n    \"includeMetadata\": true\n  }\n}\n```\n\n### Project Configuration (project.json)\n```json\n{\n  \"title\": \"My Novel\",\n  \"author\": \"Author Name\",\n  \"genre\": \"Fantasy\",\n  \"targetLength\": 80000,\n  \"style\": {\n    \"tone\": \"adventurous\",\n    \"perspective\": \"third-person\",\n    \"tense\": \"past\"\n  },\n  \"chapters\": [],\n  \"created\": \"2024-01-01T00:00:00.000Z\",\n  \"modified\": \"2024-01-01T00:00:00.000Z\"\n}\n```\n\n## Requirements\n\n- **Node.js**: Version 16 or higher\n- **OpenRouter Account**: For AI model access\n- **Terminal**: Modern terminal with color support\n- **Storage**: Minimum 100MB for projects and dependencies\n\n## Development\n\n### Prerequisites\n- Node.js 18+\n- TypeScript\n- OpenRouter API access\n\n### Setup\n```bash\ngit clone https://github.com/yourusername/bookgenai.git\ncd bookgenai\nnpm install\nnpm run dev\n```\n\n### Testing\n```bash\nnpm test                    # Run all tests\nnpm run test:watch         # Watch mode\nnpm run test:coverage      # Coverage report\n```\n\n### Building\n```bash\nnpm run build              # Compile TypeScript\nnpm run package            # Create distribution package\n```\n\n## Italian Localization\n\nBookGenAI includes full Italian language support:\n\n- Command aliases in Italian (`libro`, `scaletta`, `personaggio`)\n- Italian error messages and help text\n- Cultural considerations for creative writing\n- Italian literary conventions and style preferences\n\nEnable Italian mode:\n```bash\nbookgenai config language it\n# or\nlibro config lingua it\n```\n\n## Examples\n\n### Creating a Fantasy Novel\n```bash\n# Initialize project\nbookgenai init\n> Enter book title: The Dragon's Legacy\n> Select genre: Fantasy\n> Writing style: Epic/Adventurous\n\n# Create outline\nbookgenai outline\n> Generating epic fantasy outline with hero's journey structure...\n\n# Develop main character\nbookgenai character \"Aria Stormwind\"\n> Role: Protagonist\n> Creating brave warrior with mysterious past...\n\n# Define primary setting  \nbookgenai setting \"Kingdom of Valdris\"\n> Creating medieval fantasy kingdom with political intrigue...\n\n# Write first chapter\nbookgenai write chapter 1\n> Writing opening chapter with character introduction...\n\n# Export finished manuscript\nbookgenai export\n> Generating professional DOCX format...\n```\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n### Areas for Contribution\n- New writing tools and plugins\n- Additional export formats\n- UI/UX improvements\n- Documentation and tutorials\n- Language localizations\n- Model integrations\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Support\n\n- 📚 **Documentation**: [docs.bookgenai.com](https://docs.bookgenai.com)\n- 🐛 **Issues**: [GitHub Issues](https://github.com/yourusername/bookgenai/issues)\n- 💬 **Discussions**: [GitHub Discussions](https://github.com/yourusername/bookgenai/discussions)\n- 📧 **Email**: support@bookgenai.com\n\n## Roadmap\n\n### Version 1.0 (Current Development)\n- Core writing tools implementation\n- DOCX export functionality\n- Basic OpenRouter integration\n- Italian localization\n\n### Version 1.1 (Planned)\n- PDF export support\n- Advanced character relationship mapping\n- Plot consistency checking\n- Performance optimizations\n\n### Version 1.2 (Future)\n- Google Docs API integration\n- Collaborative writing features\n- Advanced style analysis\n- Custom tool development framework\n\n### Version 2.0 (Vision)\n- Visual interface option\n- Cloud synchronization\n- Multi-language translation\n- Publishing platform integration\n\n---\n\n**BookGenAI** - Transforming creative writing through intelligent assistance.\n\n*\"Every great story begins with a single word. Let AI help you find the rest.\"*","readmeFilename":"README.md"}