AI agents CLI

A command-line tool for your agents

A small postcaly command-line tool, plus a skill file that teaches agents how to use it. It is for agents and scripts that run on your own computer or server.

Available now on every plan

Use Postcaly today: 14 days free, then from £15.99 a month. Updated

Example
You

Upload ~/videos/tour.mp4 to Postcaly and schedule it on YouTube for Friday at 6pm, unlisted, titled 'Kitchen tour'.

Your agent

I asked the Postcaly tool to upload the video and checked YouTube's rules: the length and size are fine. It is scheduled for Friday 18:00 as an unlisted video titled "Kitchen tour". The tool returned the post's details, so I can report back when it is live.

Command-line tool and skill file

Connect the command-line tool to Postcaly

The tool talks to the same Postcaly service as the MCP server, so the rules are the same. The skill is a plain instructions file that tells an agent which commands to run. Both are public at github.com/postcaly/skills.

  1. 1

    Install the tool and the skill

    Run npm install -g github:postcaly/skills (needs Node 18 or later), or run it once with npx -y github:postcaly/skills <command>. For agents that use skills, run npx skills add postcaly/skills.

  2. 2

    Sign in with an API key

    Create a key in Postcaly under Settings, AI agents, then run postcaly login and paste it. It is stored only on that machine. Scripts can set POSTCALY_API_KEY instead.

  3. 3

    Let the agent run it

    Try postcaly channels, postcaly next-slot or postcaly draft. Every answer comes back as JSON, which agents and scripts read reliably.

Commandnpx -y github:postcaly/skills login

Available on every plan.

Things you can ask your agent

Plain requests work. Your agent does the writing; Postcaly checks each network and keeps the schedule.

  • List today's scheduled posts and print them as JSON.

  • Upload this video to the media library and save a YouTube draft with it.

  • Find the next free posting time and schedule a post for it.

  • Report every failed post from the last seven days with its error.

  • Copy last week's posts as new drafts for this week.

Made for agents on your machine

OpenClaw, NanoClaw, Paperclip and Hermes Agent run on a computer you control. A tool and a skill is the simplest way for them to reach Postcaly.

Local files, uploaded properly

Agents can upload a video or image from the machine they run on, then use it in a post.

JSON in, JSON out

Every command answers in JSON, so agents and your own scripts can use the results without guessing.

What your agent can do in Postcaly

The same actions as the Postcaly screens, with the same plan limits and network checks. You tick which permissions to give.

Read

Looks, never changes

  • See your workspaceName, time zone, plan and how many posts and channels you have left.
  • List your channelsEvery connected account, and whether any needs reconnecting.
  • Know each network's rulesCharacter limits, media rules and required choices such as a YouTube title.
  • Check a post before savingRuns the same checks as the Postcaly composer, so problems show before anything is scheduled.
  • Find the next free timeYour next posting time with nothing booked.
  • List and open postsPosts in a date range, with each channel's status and any error.

Write

Drafts for a person

  • Save draftsSaves a post for a person to finish or approve.

Schedule

Books a stated time

  • Schedule and move postsBooks a post for a time it states or your next usual time, and moves posts that have not gone out.
  • Change, unschedule or deleteEdits a post that has not gone out, returns it to drafts or deletes it.

Media

Your library

  • Add pictures and videosBrings a picture (up to 8 MB) or video (up to 50 MB) into your media library from a public link, with a description.

Publish now

Only if you allow it

  • Publish straight awayOnly if you tick it when you approve the agent.

Not included: editing or deleting posts that are already live, managing people or billing, and connecting social accounts. Those stay with a person in Postcaly.

You stay in control

You approve it

Your agent asks for access, you sign in to Postcaly and choose one workspace and what it may do. Each workspace is approved separately.

Nothing posts by surprise

Posts are only created when you ask. A scheduled post needs a stated time, and publishing straight away is off unless you allow it.

Every post is labelled

Posts made by an agent carry the agent's name in your calendar, and every action is listed under Activity.

Drafts only, if you prefer

Switch on Drafts only for a workspace and everything an agent creates arrives as a draft for your team to check.

Your limits still apply

Your plan's limits and each network's rules apply to every agent, the same as in the Postcaly screens.

Disconnect any time

Remove the agent in Postcaly under Settings, AI agents, and its access stops at once. Removed team members' access stops too.

MCP server or command-line tool?

Both reach the same Postcaly workspace and follow the same rules. Chat apps and coding agents that support MCP should use the MCP server. Agents that run on your own machine and prefer running commands, and your own scripts, should use the command-line tool. The commands are listed in github.com/postcaly/skills.

Which agents use it

When to use the command-line tool

  • Your agent runs on its own computer or server and follows a skill file, such as OpenClaw, NanoClaw or Paperclip.
  • You want scripts or scheduled jobs to read and write Postcaly with JSON output.
  • You need to upload local files, such as video, from the machine the agent runs on.

What stays with a person

Signing the tool in, connecting social accounts and approving any publish-now permission stay with you.

Questions

Is it available now?

Yes, on every Postcaly plan. Any account with a confirmed email address can connect it.

Do I need an API key?

The command-line tool uses a Postcaly API key, which you create in Postcaly under Settings, AI agents. It is stored only on the machine the tool runs on, and you can remove it in Postcaly at any time.

Which networks can it post to?

The channels connected in your workspace: today YouTube, X, LinkedIn profiles, Threads and Bluesky. Facebook Pages, Instagram, Google Business Profile, TikTok and Pinterest open as each network approves Postcaly.

Will it post without asking me?

No. The tool only does what a command asks. A scheduled post needs a stated time, and publishing straight away needs a permission you grant separately. Every post appears in your Postcaly calendar, labelled with where it came from.

Is the skill open source?

Yes. The skill and the tool are public at github.com/postcaly/skills under the MIT licence, so you can read exactly what it tells your agent to do.

Can I use the command-line tool without an AI agent?

Yes. It is an ordinary command-line tool with JSON output, so you can use it in your own scripts as well as through an agent's skill.

Schedule your first post

14 days free on every plan, then from £15.99 a month. Cancel any time.

Start your free trial