JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 425
  • Score
    100M100P100Q107017F
  • License MIT

CLI for generating rich articles and images from ideas.

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@telepat/ideon) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    Ideon

    Ideon

    Turn one idea into articles, threads, and social posts. Quality content without the token tax.

    ๐Ÿ“– Docs ยท ๐Ÿ‡บ๐Ÿ‡ธ English ยท ๐Ÿ‡จ๐Ÿ‡ณ ็ฎ€ไฝ“ไธญๆ–‡

    Build Codecov npm License

    Ideon is an AI content writer that turns a single idea into publish-ready content across multiple formats, styles, and channels. Describe your topic once, and Ideon produces an article plus X threads, LinkedIn posts, Reddit posts, newsletters, and blog posts โ€” all sharing one voice and one strategy.

    Built for marketers, founders, and lean teams who need to ship high-quality content at scale without manually rewriting one idea for every channel.

    Features

    • Write once, publish everywhere โ€” One idea turns into article, blog, newsletter, X, LinkedIn, and Reddit posts in a single run. Your article anchors the campaign. Everything else promotes it.
    • Style and intent control โ€” 13 styles ร— 13 intents. Every output shares one consistent voice across every channel.
    • Research-backed links โ€” Ideon browses the web and inserts contextual external links like a human writer would. No manual research.
    • Any model via OpenRouter โ€” Plug in Claude, GPT-4, or any supported model. Switch without changing your workflow.
    • Writing guide-driven โ€” Prompt composition grounded in proven writing principles compiled from real advice. No generic AI filler.
    • Code-driven efficiency โ€” Deterministic pipeline code handles orchestration. You pay for tokens only when drafting prose.
    • Visual storytelling โ€” Auto-generated cover and inline images via Replicate for article-led runs.
    • Agent and CI ready โ€” MCP server, non-interactive mode, machine-readable config, and resumable runs.

    Quick Start

    Install and generate your first content set:

    npm i -g @telepat/ideon
ideon settings
ideon write "How small editorial teams can productionize AI writing" --primary article=1 --secondary x-post=1
ideon preview

    Expected outcome:

    • A generation folder is written under output/<timestamp>-<slug>/.
    • One or more publish-ready Markdown outputs are produced.
    • Analytics and artifact metadata are saved for review and reproducibility.
    • Local preview opens to inspect content, links, and generated assets.

    Requirements

    • Node.js 20+
    • npm 10+
    • OpenRouter API key
    • Replicate API token

    How It Works

    Ideon runs a staged writing pipeline: planning, drafting, image prompt expansion, image rendering, channel output generation, and optional link enrichment.

    It combines configuration from settings, environment variables, job files, and CLI flags, then writes structured artifacts for traceability and reuse.

    Core commands:

    ideon settings
ideon config list --json
ideon write "An article idea" --primary article=1
ideon write --no-interactive --idea "An article idea" --primary article=1 --style technical --length medium
ideon write --job ./job.json
ideon write resume
ideon delete my-article-slug
ideon preview --no-open

    Using With AI Agents

    Ideon is built for agentic workflows:

    • MCP server โ€” ideon mcp serve exposes 5 tools over stdio for content generation, resume, deletion, and config management. Compatible with Claude Code, ChatGPT, Gemini, and any generic MCP host.
    • Agent runtime registration โ€” ideon agent install <runtime> registers integration profiles for supported platforms. Check status with ideon agent status --json.
    • Non-interactive mode โ€” ideon write --no-interactive ... removes all prompts for CI and automation.
    • Machine-readable config โ€” ideon config list --json and ideon config get <key> --json for agent inspection.
    • Skill package โ€” Install skill/ideon-cli/ into your agent host for a full lifecycle skill covering install, setup, operations, and debugging.
    • Agent docs โ€” For Agents covers MCP servers, skills, and maintenance.

    Security And Trust

    • Secrets are stored in the OS keychain by default via ideon settings.
    • In CI or containerized environments, use IDEON_OPENROUTER_API_KEY and IDEON_REPLICATE_API_TOKEN.
    • Set IDEON_DISABLE_KEYTAR=true when keychain access is unavailable.
    • Generated outputs can include model-produced content, so review content before publication.

    To report a security issue, open a private report through the repository security flow or contact maintainers through repository issue channels with minimal sensitive detail.

    Documentation And Support

    Contributing

    Contributions are welcome. Start with Development for setup, workflow, and quality gates, then follow Releasing and Docs Deploy for release and docs deployment details.

    For user-facing documentation changes, update both English and Simplified Chinese content in the same change.

    License

    MIT. See LICENSE.