How to Push AI Assets to TokRepo — Complete Guide with Real Examples

You're in Control

TokRepo is designed around one principle: you decide what gets shared. Nothing is uploaded automatically. Every push requires your explicit action — you choose the files, you choose the visibility.

This guide walks through real scenarios so you know exactly what to expect.

Scenario 1: Push a Single Skill File Privately

The simplest case — you wrote a useful skill and want to save it to TokRepo for yourself.

Key takeaway: Only code-review.md was pushed. Nothing else from your project. Private by default.

Scenario 2: Share a Skill Publicly

You want the community to benefit from your work.

Key takeaway: The AI checked for secrets before pushing. Public visibility was set because you explicitly asked.

Scenario 3: Push from CLI — Single File

Using the command line to push specific files.

# Push one file privately (default)
tokrepo push --private my-rules.md

# Output:
# tokrepo push
#   Title:      My Rules
#   Visibility: private (only you can see)
#   Files:      1 (only these files will be uploaded)
#
#   • my-rules.md (skill, 2.1KB)
#
# Pushing...
# ✓ Created!
#   URL:  https://tokrepo.com/en/workflows/...

Scenario 4: Check Before Pushing

Not sure what's changed? Use status first — like git status.

tokrepo status

# Output:
# + new      My New Skill
# ~ modified Chrome MCP Config (a7c4644c...)
# = unchanged Code Review Checklist (e7e9ac68...)
#
# 1 new, 1 modified. Run tokrepo push to sync.

Scenario 5: Let the AI Decide What's Relevant

You don't need to name exact files — describe what you want and the AI will figure it out.

Key takeaway: The AI only pushed the relevant asset, not your entire codebase.

Scenario 6: Update an Existing Asset

Pushed before and made improvements? Just push again — TokRepo auto-detects updates.

Scenario 7: Toggle Visibility After Pushing

Changed your mind about privacy? No need to re-push.

On the web:

1. Go to your asset page on tokrepo.com
2. Click "Make Public" or "Make Private"
3. Done — instant change

Via CLI:

# Check current visibility
tokrepo list

# Output shows Public/Private status for each asset

Scenario 8: Push Multiple Files as One Asset

Some assets have multiple files — like a skill with a config and a README.

# Push specific files together as one asset
tokrepo push --private --title "My Full Stack Skill" \
  skill.md config.json README.md

# Only these 3 files are uploaded — nothing else

Privacy Controls at a Glance

What TokRepo Never Does

• Never uploads files without your command
• Never changes private assets to public automatically
• Never reads files you didn't specify
• Never stores your passwords, API keys, or tokens in assets (AI checks before pushing)

Common Questions

Can my private assets be found by other users?

No. Private assets (visibility=0) are completely invisible to other users. They don't appear in search, trending, or your public profile.

What file types can I push?

Any text file: .md, .js, .py, .sh, .json, .yaml, .toml, .ts, and more. Binary files are automatically skipped.

Is there a size limit?

Individual files are limited to 500KB. An asset can contain up to 50 files.

Can I delete an asset after pushing?

Yes. Use tokrepo delete <uuid> from the CLI, or delete from the web interface.

Do I need to push from the same computer?

No. Your API token works from any device. Use tokrepo login on a new machine, or set TOKREPO_TOKEN as an environment variable.

What if I accidentally push sensitive data?

Delete the asset immediately with tokrepo delete <uuid>. If it was private, no one else has seen it. If it was public, it may have been viewed — rotate any exposed credentials.