Profile-Wrap

Plan, write, check and ship LinkedIn posts from Claude Code, inside LinkedIn's terms.

What it does

✍️ Writes posts in your voice, in English, Arabic or both as a pair. 🔢 Checks every number against facts you verified yourself. No fact, no number. 🧪 Runs deterministic gates: slop words, private terms, Arabic hygiene, links, hashtags. 🎞️ Builds slides and looping GIFs (optional, needs Node and ffmpeg). 🗓️ Plans the week, picks a posting minute inside your audience window, skips holidays. 👀 Shows every draft on a local review board. You press Allow. 🚀 Posts through the official LinkedIn API, with your own developer app. 🛑 Pauses everything with one command.

It is a Claude Code plugin and a plain command line (profile-wrap). The Python core uses only the standard library. Without Claude, without Node and without a LinkedIn app it still runs the demo, the gates and the board.

Pick how you use it

Quickstart (5 minutes)

You need Python 3.10 or newer. Nothing else.

1. Install.

uv tool install profile-wrap        # or: pipx install profile-wrap

Not on PyPI for you yet? Use uv tool install git+https://github.com/NJ-Burrito/profile-wrap. As a Claude Code plugin: /plugin marketplace add NJ-Burrito/profile-wrap, then /plugin install profile-wrap@profile-wrap.

2. Try it on a fictional person. No account, no network, no model.

profile-wrap init --demo --yes
profile-wrap demo run

demo run walks one whole fictional week for Maya Rivera: the gates (one fails on purpose), the review board, Allow, a post to a fake LinkedIn on your own machine, due, a draft and a comment from a fake claude, the scheduler preview and the leak scan. It takes about half a minute and exits 0 when every step passed. Maya, her client and her links are invented.

3. Make it yours.

profile-wrap doctor                          # what your machine can do, with the install line for your OS
profile-wrap init --express                  # 7 questions, then sensible defaults
profile-wrap facts add --claim "Cut the weekly review to 30 minutes" --numbers "30 minutes" --source notes/review.md
profile-wrap facts verify F01 --evidence notes/review.md     # only you, in a terminal
profile-wrap calendar fill --weeks 1
profile-wrap build-week --dry-run

In Claude Code, say "set up LinkedIn" or run /profile-wrap:setup. The interview resumes where it stopped. A first real draft needs no LinkedIn app: copy mode gives you a block to paste.

4. Connect your own LinkedIn app (optional, when you want posting). Follow docs/linkedin-app-setup.md, then profile-wrap auth and profile-wrap selftest. Posting stays click-to-send: you press Allow on the board, then profile-wrap post <slug> --now.

More detail: QUICKSTART.md.

How it keeps you inside LinkedIn's terms

Profile-Wrap is built so the unsafe actions have no code path. It cannot promise how LinkedIn treats your account. Read docs/TERMS-AND-RISK.md first.

The fact gate is a traceability guarantee, not a truth guarantee: it proves each number came from a fact you verified, not that the fact is true.

Commands

Claude Code skills and commands

Slash commands: /profile-wrap:setup, :week, :post, :board, :doctor, :pause. Review seats (council-*) read only; writers (crew-*) edit only the draft they are given.

FAQ

Is this allowed by LinkedIn? Copy mode and click mode use only what LinkedIn gives every developer (the official Posts API, one human click per post). Unattended posting, API comments and likes sit in a grey area of LinkedIn's terms, are off by default, and need a typed acknowledgement. Read docs/TERMS-AND-RISK.md. It is not legal advice.

Does it cost money? The package is free (MIT). LinkedIn's developer app is free. AI drafting uses your own Claude Code plan or API key; the demo, the gates and copy mode need none.

Can it send connection invites or read my messages? No. The invitation API is partner-only, and reading messages is not allowed. It drafts; you click.

Does it work in Arabic? Yes, as a first-class language: right-to-left checks, Arabic hygiene rules (hamza, taa marbuta, Persian letters, invisible characters, mixed numerals), and bilingual pairs fixed together.

Does it ship fonts? No. No font, photo or signature is bundled. profile-wrap fonts fetch installs an open-licence default, or you point it at fonts you are licensed to use.

Where is my data? In a folder that is its own git repository (~/profile-wrap/<profile>). Secrets live in your config folder, never in the workspace. See docs/PLATFORMS.md.

A post says needs_check. LinkedIn did not confirm it. Open LinkedIn, look, then run profile-wrap post <slug> --resolve --posted or --not-posted. It never reposts on its own.

How do I stop everything? profile-wrap pause --all, then profile-wrap schedule remove.

It broke. profile-wrap doctor, then docs/TROUBLESHOOTING.md.

Roadmap

Details and what is not planned: docs/ROADMAP.md. v0.2 features are not in v0.1; the board's Comments and Connect tabs stay empty until then, and the demo fills them with fictional rows.

Contributing, security, licence

CONTRIBUTING.md · SECURITY.md · CHANGELOG.md · THIRD_PARTY.md

Licence

MIT. See LICENSE. Profile-Wrap is not affiliated with or endorsed by LinkedIn; see NOTICE.md.