Skip to content

About

Agent-ready CLI for Museon's social media operating platform

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Museon logo

Museon CLI

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.

Give this to your Agent

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.

What happens next

  1. Your Agent installs Museon CLI. It installs the exact Python wheel from the official GitHub release and verifies that the command is available.
  2. 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.
  3. You approve access in the browser. Sign in to Museon and choose the organization the Agent may use.
  4. 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.

Agent capabilities

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.

Organizations only (1.0.0)

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-id are unknown (usage error, exit 2). A workspace_id in structured input is refused before any request.
  • agentic-campaign and hireaicreator are unchanged in 1.0.0: they keep their deprecated --workspace-id and the envelope workspace key 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_outdated with the upgrade command. See the changelog for every change.

You stay in control

  • 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.

Install without an Agent

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 whoami

Use --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.

Version and upgrades

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

CI Python

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.py

Command 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.py

See CONTRIBUTING.md and the Code of Conduct to contribute. Release notes live in CHANGELOG.md. Please report security issues privately by following SECURITY.md.

License

Museon CLI is licensed under the Apache License 2.0.

About

Agent-ready CLI for Museon's social media operating platform

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages