Creative Agent is a local-first CLI and four Codex skills for collecting, searching, generating, and presenting YouTube inspiration.
import-youtube-inspoimports public videos, channels, and playlists into the local library.find-youtube-insposearches and curates title and thumbnail references.generate-insporemixes a curated selection into original title and thumbnail concepts.create-inspo-pageturns a working selection into a standalone visual board that can be previewed or published.
For a complete agent-led installation and user onboarding workflow, see SETUP.md.
Use Node.js 24 and pnpm 11:
pnpm install
pnpm cli statuspnpm cli is the repository-local command prefix. For example:
pnpm cli auth status
pnpm cli videos listBuild dist/ and link the creative-agent executable when a command available outside the checkout is useful:
pnpm build
pnpm link --global
creative-agent statusCanonical input and output are JSON. Commands that accept JSON read it from stdin. Their current input contracts are available as JSON Schema:
pnpm cli schema embed
pnpm cli schema videos-upsert
pnpm cli schema channels-upsert
pnpm cli schema videos-searchLocal state is initialized beneath ~/.creative-inspo-agent/. Set CREATIVE_AGENT_HOME to use a different root.
Video imports may include normalized channel records and retained avatars in the same atomic
videos upsert batch. channels upsert is also available for channel-only enrichment and
backfills without re-embedding videos.
Start the read-only Assets Explorer with one command:
pnpm assets:devThe React/Vite client reads the live local database through a loopback-only Effect HTTP server.
It provides dense infinite browsing, avatar-based creator filtering, random/newest/oldest/most
viewed sorting, and direct YouTube links without authentication or write actions. See
apps/assets-explorer/README.md for its service boundaries and configuration.
pnpm validate