Imagent means Imagine agent: a local-first image and video generation workspace for individual creators, automation-heavy workflows, and AI agents.

It ships as a desktop application, a command-line tool, and an installable agent skill. All surfaces share the same local workspace, provider configuration, asset library, generated outputs, and result history.

Documentation · Desktop app · CLI · Architecture

Why imagent?

Capability	What it gives you
Local-first workspace	Data lives under ~/.imagent/, including SQLite state, configuration, assets, and generated outputs. No remote account or backend is required.
One library across interfaces	The desktop app, CLI, and agent integrations work against the same gallery, boards, favorites, and reusable assets.
Multi-provider generation	OpenAI, Azure OpenAI, Google Imagen/Gemini, Flux/BFL, BytePlus / 火山引擎 Seedream/Seedance, and xAI Grok can be configured side by side.
Asset-driven creation	Reusable characters, objects, backgrounds, styles, and references help keep ongoing projects visually consistent.
Agent-ready automation	The bundled skill lets compatible agents call the imagent CLI instead of using a one-off image or video tool.

Quick start

Install the CLI:

npm install -g @imagent/cli
imagent doctor

Install the desktop app:

• Download the macOS or Windows installer from the latest release.

• The desktop app is not signed yet. On macOS, remove quarantine before opening the app:

  xattr -cr Imagent.app

• On Windows, bypass the SmartScreen warning by choosing More info → Run anyway.

Generate with defaults:

imagent image generate "minimal product photo of a ceramic mug"
imagent video generate "a slow dolly shot through a rainy alley"

Need setup details, provider configuration, desktop installation, or troubleshooting? Visit the documentation site:

https://unliftedq.github.io/imagent/docs

Agent skill integration

The repository includes a ready-to-install skill at skills/imagent. Install it into any compatible agent runtime, then make sure the imagent CLI is available on that agent's PATH.

npx skills add unliftedq/imagent

Use the same install flow for Claude Code, Codex, OpenClaw, Hermes, or other compatible agents. After installation, the agent can run imagent doctor to decide whether to use the shared local gallery and configured providers, or fall back to another generation tool when imagent is not configured.

Typical workflows

• Build a local AI-assisted visual creation workflow for individual use.
• Compare image and video outputs across multiple generation providers.
• Maintain reusable characters, styles, and reference-image assets over time.
• Combine terminal automation with desktop-based review and curation.
• Let coding agents generate creative assets through the same audited CLI workflow.

Project structure

imagent/
  apps/
    desktop/      # @imagent/studio, Electron desktop application
    cli/          # @imagent/cli, command-line interface
  packages/
    core/         # domain types, ports, and job runtime logic
    providers/    # provider adapters and model catalog
    persistence/  # SQLite, migrations, repositories, file and thumbnail handling
    config/       # configuration and secret management
    ipc/          # desktop IPC contract
    ui/           # shared UI components

Current status

imagent remains in an early stage. Data structures, packaging, and parts of the feature set may continue to evolve. The current version does not include telemetry, automatic updates, cloud sync, or account systems. Desktop packages are unsigned, so macOS may require removing quarantine and Windows may show a SmartScreen warning on first launch.

License

By contributing to imagent, you agree that your contributions will be licensed under the project's Apache License 2.0. You also confirm that you have the right to submit the work under that license.

Acknowledgements

Phosphor icons, Radix UI, Tailwind CSS v4, Bun, Turborepo, Vite, Electron, Commander, zod, zustand, better-sqlite3, sharp, ffmpeg-static, @dnd-kit.