OpenSkillIndex← back to search
claude-code

ClawedBack oc-files

Manage files and create temporary share links for the web chat. Use when the user says 'share file', 'send file', 'list files', 'download', or when you need to provide a file to the user via the chat. Also use when you generate a file (PDF, image, code, etc.) and want to let the user download it.

install
source · Clone the upstream repo
git clone https://github.com/reedmayhew18/ClawedBack
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/reedmayhew18/ClawedBack "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/oc-files" ~/.claude/skills/reedmayhew18-clawedback-oc-files && rm -rf "$T"
manifest: .claude/skills/oc-files/SKILL.md
source content

File Manager

Store, organize, and share files with the user via temporary download links.

Sharing a File with the User

When you create or have a file the user should be able to download, use the share command:

cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py share <file_id> --name "Report.pdf" --duration 3600

This returns a JSON with a 

url
field. Send that URL as a markdown link in your response:

[Report.pdf](http://localhost:8080/files/abc123def456.pdf?filename=Report.pdf)

The user clicks it and downloads the file. The link expires after the duration (default: 60 minutes, max: 7 days).

Storing a New File

If you generated a file (wrote it to disk), store it in the organized file system first:

cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py store /path/to/file.pdf --name "Report.pdf" --type generated

Then share it:

cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py share <file_id> --name "Report.pdf"

Types: 

upload
(user uploaded), 
voice
(voice recording), 
generated
(you created it), 
output
(command output).

Commands

# List all stored files
cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py list

# List files from a specific date
cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py list --date 2026-04-05

# Get the disk path for a file ID
cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py get <file_id>

# Share a file (default 60 min)
cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py share <file_id> --name "File.pdf" --duration 3600

# Share for longer (e.g., 24 hours)
cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py share <file_id> --duration 86400

# Revoke a share early
cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py unshare <share_uuid>

# List active shares
cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py shares

# Clean up expired shares
cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py cleanup

Workflow: User Asks for a File

  1. Create/find the file on disk
  2. file_manager.py store <path> --name "name.ext" --type generated
    → get 
    file_id
  3. file_manager.py share <file_id> --name "name.ext"
    → get 
    url
  4. Send in chat: 
    [name.ext](url)

Workflow: Reading a User's Uploaded File

User uploads come through with a 

file_id
in the message metadata. To read:

cd $PROJECT_ROOT/.claude/skills/oc-poll/scripts && python file_manager.py get <file_id>

This prints the absolute path — then use the Read tool on that path.

Duration Limits

  • Minimum: 60 seconds
  • Default: 3600 seconds (1 hour)
  • Maximum: 604800 seconds (7 days)

File Organization

Files are stored in 

data/files/YYYY/MM/DD/<file_id>.<ext>
. The manifest at 
data/files/manifest.json
tracks all files with metadata. Shares are tracked in 
data/files/shared_files.json
with expiry timestamps.