cc-studio

Your own content team for short-form video, running on your computer. cc-studio plans a week of TikTok and Instagram posts, makes each video with Claude, asks you to approve it, and schedules the ones you approve. cc, a small desktop companion, keeps you in the loop the whole time.

Nothing is posted without your yes. You decide what videos may claim, which accounts they go to, and whether they post automatically or wait for you to press Post.

Contents

• What you get
• How a week works
• Before you start
• Setup, step by step
• Your first week
• Everyday use
• Troubleshooting
• Where your settings live
• Responsible use · Contributing · License

What you get

• A weekly plan per account. It reads each account's own analytics, your competitors' recent posts and current trends, then plans next week: hook, script, caption, hashtags, posting time and a different visual idea for every post.
• Finished videos. Claude builds each post into a 1080x1920 video from your real screenshots and footage (with HyperFrames, Remotion or ffmpeg), adds an ElevenLabs voiceover and music if you have a key, checks its own frames, and makes sure it doesn't look like your recent videos.
• Approval on your phone or desktop. Each video comes to you in Telegram or in cc's chat with three buttons: Approve, Redo (with your note) or Skip.
• Scheduling. Approved videos go through TikTok Studio's own scheduler, up to 7 days ahead, in your real Chrome with your own login. Instagram works through the browser or the official Graph API.
• cc on your desktop (Windows). Its ponytail shows what's happening (blue: all good, orange: making a video, pink: a video is waiting for you, red: a problem). Click it to chat, hear it talk in an offline voice, and use buttons for every action. When you leave it alone, it hides at the edge of your screen with just its ponytail poking out.

How a week works

 Saturday evening     every 30 minutes            you                 every 30 minutes
┌────────────────┐   ┌──────────────────┐   ┌──────────────┐   ┌──────────────────────┐
│ read analytics │──►│ make the next    │──►│ Approve /    │──►│ schedule it on       │
│ plan next week │   │ video (Claude)   │   │ Redo / Skip  │   │ TikTok or Instagram  │
└────────────────┘   └──────────────────┘   └──────────────┘   └──────────────────────┘

It makes one video at a time, so you're never flooded: when one is waiting for you, it waits too. Every step can be stopped at any point (a reboot, sleep, a crash) and simply continues on the next run.

Before you start

You need these on your computer. The commands are for Windows (run them in PowerShell); on a Mac use the links instead.

After installing Claude Code, run claude once in a terminal and log in (a Claude subscription or an API key both work). Close and reopen your terminal after the installs so the new commands are found. To check everything at once later, run npm run doctor.

Optional, but recommended:

• A Telegram account, to approve videos from your phone. Setup walks you through making a bot; it takes two minutes.
• An ElevenLabs API key (elevenlabs.io, Profile > API keys) for spoken voiceovers and music. Without it, videos use on-screen text and your own music.

Which systems? Everything works on Windows 10 and 11. On macOS and Linux the pipeline runs (with cron instead of Task Scheduler), but cc, the desktop companion, is Windows-only, so you'd approve videos in Telegram.

Setup, step by step

1. Download and install

git clone https://github.com/gsl0001/cc-studio.git
cd cc-studio
npm install

2. Run setup

npm run setup

Your browser opens a chat with cc (a page served from your own computer, at localhost:4829; nothing is sent anywhere). Keep the terminal window open until you finish. Answer by typing or by tapping the buttons; pressing Enter on an empty box keeps the value shown.

Here is everything it asks, in order:

Prefer the terminal? npm run setup:cli asks the same questions there.

3. The finishing steps

After saving, setup shows a list of buttons. Each runs right there and shows its progress:

1. Log in to each account. A Chrome window opens on TikTok or Instagram. Log in by hand (cc-studio never types a password), then close the window. That login is kept in browser-profile/, so treat that folder like a password.
2. Build my look. Draws cc's avatar (needs Python).
3. Install my voice. An offline voice for cc (downloads about 340 MB). Until then cc uses the Windows voice.
4. Start the schedule. Registers the jobs in Windows Task Scheduler and starts cc, the desk server and the Telegram bot. No admin rights needed; they run while you're logged in.
5. Health check. Lists anything still missing, each with the command that fixes it.

You can run any of them again later: npm run login -- <account-id>, npm run avatar, npm run voice:install, npm run tasks:install, npm run doctor.

4. Give it real material

The better the material, the better the videos:

• Put your logos, app screenshots, screen recordings and photos in workspaces/<project>/assets/. Add brand rules (colours, fonts, words to avoid) to workspaces/<project>/README.md; the creator reads it before every video.
• Fill in content/CONTEXT.md: who each account is for and the words people search for.
• Optionally edit content/GUIDELINES.md, the house rules for every video.

Your first week

• Plan. The plan is made every Saturday evening. Don't want to wait? Run npm run strategist to plan the coming week now.
• Make. Every 30 minutes the pulse checks whether a video is needed and starts the creator. A video usually takes well under an hour (90 minutes at most).
• Approve. When it's ready, cc turns pink and Telegram pings you. Watch it, then Approve, Redo with a note ("make the hook shorter"), or Skip.
• Post. Approved videos are scheduled from 08:00 onward, at most one upload per run, at the times you set.
• Learn. Next Saturday it reads how the videos did, and the next plan builds on it.

Everyday use

With cc (click it to open the chat). These answer instantly:

Anything else goes to Claude, which answers from the live state of your pipeline. Right-click cc for its menu: voice, colour, size, auto-hide.

In Telegram: each new video arrives with Approve / Redo / Skip buttons, and pause, resume, next and status work there too.

In a terminal: npm run status (the jobs), npm run logs -- --errors (recent problems), npm run doctor (a health check), npm run registry (checks your project files).

Troubleshooting

Start with npm run doctor: it checks every part and says how to fix what's wrong.

Reporting a bug? Include the lines from npm run logs -- --errors and the output of npm run doctor.

Where your settings live

Everything is plain files you can open and edit. None of them are uploaded anywhere, and the ones with your details are kept out of git.

Every setting is explained in docs/configuration.md. How the parts fit together is in docs/architecture.md, and Instagram's official API setup is in docs/instagram-api-setup.md. apps/example/ is a complete fictional project to copy from.

Responsible use

cc-studio automates your own accounts through your own logged-in browser. Platforms' terms of service limit automation and they change, so you're responsible for how you use it. It's built to stay on the right side of them: a person approves every video, you set the posting volume, the AI-content label matches what was actually made, and it never buys engagement, follows for follows, or uses unlicensed music.

The creator runs Claude Code on its own while it makes a video. Read SECURITY.md for what that means and how logins and secrets are kept.

Contributing

Issues and pull requests are welcome; see CONTRIBUTING.md. Run npm test before you open a pull request.

License

MIT