@agos-labs/noimosai-cli

CLI client for NoimosAI — AI-powered social media marketing platform. Chat with AI agents, generate content, and publish posts directly from your terminal.

Features

• Chat — Interactive or one-shot conversations with NoimosAI agents (marketing analysis, content generation, SEO, etc.)
• Publish — Push generated content to your connected accounts.
• Workspace / Agent / Integration management — Inspect available agents, integrations, and workspaces from the CLI.
• Scriptable — All commands accept flags (no required interactive prompts) and support --output json for machine-readable results.

Supported publishing platforms

Both short-form social posts and long-form articles can be published from a single posts.json file.

| Type | Platform | | ----------- | --------------------------------------------------------------------------------- | | SNS | X (Twitter), Threads, Facebook, Instagram, YouTube, LinkedIn, TikTok, Bluesky, Pinterest | | Article | WordPress, note |

The platform field in each post entry (e.g. "wordpress", "note", "x", "linkedin") determines the destination. The same noimosai post command handles all of them.

Installation

pnpm add -g @agos-labs/noimosai-cli
# or
npm install -g @agos-labs/noimosai-cli

Requires Node.js >= 18.

Quick Start

# 1. Log in (opens browser for OAuth, or pass --api-key)
noimosai login

# 2. Start chatting with your agents
noimosai chat

Commands

Run noimosai <command> --help for full options on any command.

Authentication

| Command | Description | | -------------------------------- | ---------------------------------------- | | noimosai login | Interactive login (browser OAuth or API key) | | noimosai login --oauth | Force browser OAuth | | noimosai login --api-key <key> | Non-interactive API key login (CI/CD) | | noimosai logout | Remove stored credentials |

Chat (most common)

| Command | Description | | --------------------------------------------- | ------------------------------------ | | noimosai chat | Interactive chat session | | noimosai chat -p "<message>" | One-shot prompt | | noimosai chat -p "<message>" --agent <id> | Send to a specific agent | | noimosai chat -r <session-id> | Resume a previous session | | noimosai chat -p "<message>" -o json | JSON output (scripting / piping) | | noimosai chat -w <workspace-id> | Override default workspace |

Publishing

noimosai post posts.json --dry-run                     # Preview what would be sent
noimosai post posts.json --now                         # Publish immediately
noimosai post posts.json --schedule "2026-04-10 09:00" # Schedule
noimosai post posts.json --now -o json                 # JSON result for scripts

posts.json is normally produced by the chat session (the agent emits it for you). When hand-crafting it, the schema is:

{
  "version": "1",
  "metadata": { "generatedAt": "2026-04-27T09:00:00Z" },
  "posts": [
    {
      "platform": "WordPress",        // display label — see table below
      "dataKey": "wpPostData",        // routing key — REQUIRED, drives publishing
      "providerAccountId": "...",     // required for publishing (not for --dry-run)
      "textBlocks": [{ "text": "..." }],
      "media": []
    }
  ]
}

| Platform (label) | dataKey | | ---------------- | ------------------ | | X (Twitter) | xPostData | | Threads | thPostData | | Facebook | fbPostData | | Instagram | igPostData | | YouTube | ytPostData | | LinkedIn | linkedinPostData | | TikTok | ttPostData | | Bluesky | blueskyPostData | | Pinterest | pinterestPostData| | Note | notePostData | | WordPress | wpPostData |

Workspace / Integrations

| Command | Description | | ----------------------------- | ------------------------------------------ | | noimosai workspace list | List workspaces you can access | | noimosai integration list | List connected external integrations |

Configuration

| Command | Description | | -------------------------------- | ------------------------------------ | | noimosai config show | Show current configuration | | noimosai config get <key> | Read one config value | | noimosai config set <key> <val>| Set a config value | | noimosai config path | Print path of the config file |

Global options

• -o, --output <text|json> — Output format (default text). json is intended for scripts / agents.
• --help — Available on every command and subcommand.

CI / Agent usage

This CLI is designed to be driven by both humans and AI agents. Recommended patterns:

# Headless login
noimosai login --api-key "$NOIMOS_API_KEY" -o json

# One-shot prompt, JSON result
noimosai chat -p "Draft a LinkedIn post about our launch" -o json

# Idempotent dry-run before any destructive publish
noimosai post posts.json --dry-run
noimosai post posts.json --now -o json

Troubleshooting

• Cannot find package 'zod' — your global install is older than 0.0.2. Re-install: npm i -g @agos-labs/noimosai-cli.
• Not authenticated — run noimosai login again.
• Workspace ID not configured — re-run noimosai login, or pass -w <workspace-id> per command.