How to connect TikTok to Gemini CLI
- 1
Paste the install line in Gemini CLI
Google's Gemini CLI runs in your terminal and can run commands, so the install is the same single line as for Claude Code. It adds the Scorper skills to Gemini CLI and links this machine to your account with a scoped key. No API key to paste, no config file to edit.
Type into the Gemini CLI chat, or into any terminalnpx scorper@latest init
Needs Node 18 or newer. scorper doctor confirms the install afterwards.
- 2
Sign in with the code from your email
Gemini CLI asks for your email. A 6-digit code arrives, you type it into the chat. No account yet? One is created on the spot, no password. You pick a plan and its 7-day free trial starts at checkout.
- 3
Say “connect my tiktok”
Gemini CLI opens TikTok's approval page in your browser. Log into the right TikTok account first, approve, come back. Gemini CLI confirms the connection.
- 4
Tell it what to post
post the video on my desktop called diethacks.mp4 to instagram and tiktokGemini CLI uploads the media, proposes a caption, then reads the whole post back. Say yes and it publishes to TikTok. Say “schedule it for 6pm tomorrow” instead and it queues it.
What you can publish to TikTok from Gemini CLI
Video posts and photo carousels to a connected TikTok account.
TikTok requires the person posting to choose a privacy level, whether comments, Duet and Stitch are allowed, and to confirm TikTok's consent text for every post, so your AI asks you those questions before it publishes; it cannot fill them in for you. Most people connect TikTok alongside Instagram and post the same vertical video to both in one prompt. Say "post diethacks.mp4 to instagram and tiktok" and your AI uploads the file once, writes a caption for each (TikTok captions can be much longer and hashtags matter more there), reads both back and publishes. Scheduling works the same way as any other platform.
TikTok's own rules, which your AI works within
| Rule | TikTok |
|---|---|
| Video | MP4 or MOV, vertical 9:16 works best, up to 10 minutes from most accounts. |
| Caption | Up to 4,000 characters including hashtags. |
| Photo posts | Up to 35 images per photo carousel. |
| Visibility | The post's privacy level is set at publish time (public, friends, private). |
Prompts that work in Gemini CLI
Scheduling: “schedule this for 9am monday on tiktok”. The calendar: “what's going out this week?”. Moving things: “move friday's post to saturday”. Everything you schedule from Gemini CLI also shows in the dashboard calendar.
Something only Gemini CLI users should know
The account link belongs to the machine, not the agent. If you switch between Gemini CLI and Claude Code or Codex on the same computer, run the install from each one to add its skills, and they all post through the same connected accounts. scorper doctor shows which agents on the machine have the skills.
What happens before anything posts
⏺ Posting to TikTok @yourbrand Caption: "Three things I wish someone told me at 21…" Confirm? > yes ✓ Posted · link below
Honest limits
- TikTok publishing goes through the official TikTok API, so TikTok's rules above apply. Scorper does not work around them.
- The AI-agent connection is on every plan. Pro posts to Instagram only. Max ($25 a month), Studio and Agency post to every social.
- The install needs Node 18 or newer on the machine.
- Some things are easier in the dashboard than in chat: bulk-editing a month of scheduled posts, for example. Both views share one calendar.
Frequently asked questions
- Can Gemini CLI post to TikTok on its own?
- Not without a connection. Gemini CLI can write a caption but has no permission to publish. Scorper is that permission: one command installs the posting skills and links your machine to your account, then Gemini CLI can publish and schedule to TikTok through the official API.
- Does TikTok posting need a business account?
- No. TikTok's publishing works with personal and business accounts. You approve the connection once in your browser.
- Can I post the same video to TikTok and Instagram at once?
- Yes. Name both platforms in one prompt. The file uploads once and each platform gets its own caption.
- How do I know the skills are installed for Gemini CLI?
- Run scorper doctor. It lists each agent it found on the machine (Claude Code, Codex, Gemini CLI, Cursor) with a tick or a cross. A cross next to Gemini CLI means run npx scorper@latest init from Gemini CLI once more.
- Will it post without asking me?
- No. Gemini CLI reads the exact post back (platform, media, caption) and publishes only after you confirm. Scheduled posts are shown before they are queued.
- What does posting to TikTok from Gemini CLI cost?
- The AI-agent connection is on every plan: Pro ($15 a month) posts to Instagram only, Max ($25) to all five platforms for one brand, Studio ($55) runs 3 brands and Agency ($99) runs 10. Every plan starts with a 7-day free trial, card needed to start.
Connect TikTok to Gemini CLI in two minutes
Paste the line, approve in your browser, tell it what to post.
npx scorper@latest initStart free for 7 days 7 days free on every plan. The AI-agent connection is on every plan, from Pro ($15/month, Instagram) to Max ($25, every social).