Turn the AI agent you already use into a social media operator.
Research, create, publish, and learn — with your approval where it matters.
Website · Workflow Skills · Research Skill · 简体中文
Museon CLI gives the AI agent you already use the tools to research social content, understand what works, create new material, publish with your approval, and learn from real performance.
You keep working with your Agent. Museon gives it the social-media capabilities needed to move from an idea to real work.
The bundled base Skill defines Mel, your AI social-media operator. For Museon
work, it guides your Agent to own the goal, execute through Museon CLI, verify
results, and use real performance to improve the next round. This positioning is
included in the CLI package and installed by museoncli setup.
Copy the instruction below into Codex, Claude Code, Cursor, or another Agent that can install Skills and run shell commands:
Set up Museon CLI for this agent by following this onboarding guide exactly:
https://www.museon.ai/cli/install.md
That is the recommended installation path. You do not need to clone the repository, choose CLI flags, or configure credentials by hand.
- Your Agent installs Museon CLI. It installs the exact Python wheel from the official GitHub release and verifies that the command is available.
- Museon CLI installs the Skills. The bundled, same-version workflow Skills teach the Agent how to route and use Museon safely and add the Instagram Hook research workflow. ego lite is installed separately when authenticated browsing is needed.
- You approve access in the browser. Sign in to Museon and choose the organization the Agent may use.
- You describe the work, not the commands. The Agent discovers the right Museon actions and keeps the task moving.
Once connected, try a request like this:
Research the AI note-taking content gaining momentum on TikTok and Instagram.
Explain the repeated hooks and audience questions, then propose three carousel
ideas for our product. Do not publish anything until I approve it.
This working tree prepares the CLI 2.0 surface; the pinned installation below remains at the last published release until a separate release is approved.
| Outcome | Domains |
|---|---|
| Research public content and Hooks | research |
| Plan, inspect, edit and verify HireAICreator content | hireaicreator |
| List, create, launch and set up Campaigns of both kinds (UGC and content tracking); read their Dashboard figures; track creators and posts | campaign |
| Edit UGC briefs, brief assignments and which brief a creative cites; run a UGC campaign day to day (tasks, roster, creator messages, content review, recruiting); broadcast to creators, set team reminders and automatic creator nudges; generate, review and send client reports | ugc |
| Create, edit and delete multi-Campaign analytics boards | analytics |
| Analyze video content | content-analysis |
| Upload files, import image URLs and read media records | media |
| Validate, host and share durable reports | artifacts |
| Upload HTML pages and share them with customers without a login | html-documents |
| Connect and inspect accounts, use bound phones, read performance and edit profiles | social-account |
| Schedule Agent work and retain run memory | routines |
| Discover organization methodology | skills |
Eight bundled Skills teach discovery, research, durable artifacts, account access, Hook analysis, monitoring and routines. The CLI executes atomic operations; the Agent composes workflows. Museon checks user, organization role and Campaign scope for every request. Verify writes with readback from the owning domain, not with a request receipt alone.
HTML uploads now enable link sharing by default. Use
museoncli html-documents +upload --file ./proposal.html --title "Customer proposal"
and give the customer the returned data.share_url. Anyone with that link can open it.
For internal material, add --private; existing documents remain private until explicitly
shared with html-documents +share --id <document-id>. +unshare --id <document-id>
stops new visits through the current link; sharing again restores a custom name
or creates a new random link. Add --share-slug manus-proposal when uploading or
sharing to choose museon.ai/share/manus-proposal. A private upload can reserve
that name without making the document public. To return to a random link, use
html-documents +share --id <document-id> --random-link.
Use +list to recover document IDs and share URLs after an uncertain upload result;
uploading again creates another document. This change requires the HTML-sharing API release.
Which command does a job? museoncli guide lists every task by chapter (UGC Campaign
operations in the order the work happens, tracking, analytics, accounts and publishing,
AI image posts, research, the organization); museoncli guide <task-id> gives its
commands in order with their required flags, risk and gotcha; museoncli guide --search <words> finds a task from the user's words, in English or Chinese. It runs locally and
needs no login. The same guide is published as guide.md and indexed by
llms.txt.
See the migration guide before replacing an older CLI. The HireAICreator domain is included in this unpublished candidate.
MuseOn has organizations only: access is an organization role plus Campaign scope.
Every request addresses the selected organization with X-Organization-Id; pass
--organization-id <org> to a command to address another organization for one call.
1.0.0 removed the workspace aliases that 0.25 kept:
| Before (0.25 and earlier) | Now (1.0.0) |
|---|---|
museoncli workspace list |
museoncli org list (role, campaign_scope, is_default) |
museoncli workspace current |
museoncli org current |
museoncli workspace select --id <ws> |
museoncli org select --id <organization-id> or --name <exact name> |
--workspace-id <ws> on a command |
drop it, or --organization-id <org> for one call |
workspace_id in --args-json / --args-file |
drop it |
envelope .workspace |
envelope .organization ({id, name} or null) |
museoncli workspace ...and--workspace-idare unknown (usage error, exit 2). Aworkspace_idin structured input is refused before any request.agentic-campaignandhireaicreatorare unchanged in 1.0.0: they keep their deprecated--workspace-idand the envelopeworkspacekey until they move to organizations.- The Museon API requires CLI 1.0.0 or newer once its organization-only routes ship;
older CLIs get HTTP 426
cli_outdatedwith the upgrade command. See the changelog for every change.
- Research and other read-only work can run as part of the task.
- Creating, changing, scheduling, publishing, or deleting something requires the approval rules described by the command.
- The Agent must explain the intended change before a sensitive operation.
- Credentials stay in the Agent's local environment. Museon CLI uses the operating-system credential store when available and a mode-0600 file only in headless environments; an Agents-hosted session instead uses an exclusive, short-lived private lease that cannot fall back to a user API key. Authorization decisions remain on Museon's servers. See Authentication credential providers.
If you prefer to install the CLI yourself, use Python 3.11+, uv, and the exact
wheel from the official GitHub release:
uv tool install "https://github.com/Museon-AI/museon-cli/releases/download/v3.1.0/museoncli-3.1.0-py3-none-any.whl"Then continue with Skill setup and browser authorization:
museoncli setup --agent codex
museoncli auth start
museoncli auth finish --wait
museoncli skills +list
museoncli whoamiUse --agent claude-code or --agent cursor for those hosts; --agent auto
uses the active host marker, or a single existing supported Agent home. If
several Agent homes exist, choose one explicitly or use --agent all. Restart
the Agent after installing the Skill. After authentication, skills +list
shows the Business Skills available in the current organization. auth finish --wait waits for approval
for up to five minutes by default; use --timeout to change that limit. The
shorter museon command is an alias for museoncli.
museoncli version shows the running version, the latest stable release, how the CLI
was installed and the command that upgrades it. The official uv tool install upgrades
itself before a command runs; museoncli upgrade does it on demand. Installed another
way (pip, pipx), the CLI cannot replace itself: every command's JSON then carries
_notice.update with the upgrade command for your Agent to pass on, a terminal gets one
line a day, and museoncli upgrade prints the command. Set MUSEONCLI_UPDATE_CHECK=0
to pin a version; source checkouts and host runtimes are updated by their owner.
Develop Museon CLI
uv sync --frozen --all-groups
uv run ruff check .
uv run pytest -q
uv run python scripts/gen_command_docs.py --check
uv run python scripts/gen_command_contract.py --check
uv build --wheel
uv run python scripts/verify_public_artifacts.pyCommand definitions live in museoncli/domains/. When a command changes,
regenerate the documentation and portable command contract:
uv run python scripts/gen_command_docs.py
uv run python scripts/gen_command_contract.pySee CONTRIBUTING.md and the Code of Conduct to contribute. Release notes live in CHANGELOG.md. Please report security issues privately by following SECURITY.md.
Museon CLI is licensed under the Apache License 2.0.