Skip to main content

Import & Export

Rephlo lets you backup, share, and migrate your commands, spaces, and history data. This is essential for preserving your work, collaborating with team members, or moving to a new computer.

IMPORT/EXPORT OVERVIEW
======================

┌─────────────────────────────────────────────────────────────────────────┐
│ YOUR REPHLO DATA │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │
│ │ Commands │ │ Spaces │ │ History │ │
│ │ (JSON) │ │ (ZIP) │ │ (CSV) │ │
│ └───────┬───────┘ └───────┬───────┘ └───────┬───────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ EXPORT │ │
│ │ ▼ ▼ ▼ │ │
│ │ commands.json spaces.zip history.csv │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ IMPORT │ │
│ │ ▼ ▼ │ │
│ │ commands.json spaces.zip (History: export only) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ NEW COMPUTER / TEAM MEMBER / BACKUP │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘

Command Import/Export

Commands are exported as JSON files, making them portable and easy to share.

What Gets Exported

Each command export includes:

PropertyDescription
NameThe command's display name
DescriptionWhat the command does
InstructionThe AI prompt/instructions
ExecutionModeStandalone or Combination
IsFavoriteWhether it's marked as a favorite
FixedContentAppendAny fixed text appended to input
HideFromContextMenuVisibility in the quick-access menu

Exporting Commands

From the File Menu

  1. Go to File > Export Commands
  2. Choose Export Selected or Export All
  3. Select a location and filename
  4. Save as .json

From the Commands View

  1. Open Dashboard > Commands
  2. (Optional) Select specific commands using checkboxes
  3. Click the Export/Import dropdown in the toolbar
  4. Choose Export Selected or Export All
┌─────────────────────────────────────────────────────────────────────────┐
│ COMMANDS TOOLBAR │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ [+ New Command] [AI Builder] [Search...] [Export/Import ▼] │
│ ┌──────────────────────┐ │
│ │ Export Selected │ │
│ │ Export All │ │
│ │ ───────────────── │ │
│ │ Import Commands │ │
│ └──────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘

Importing Commands

  1. Go to File > Import Commands (or use the Commands toolbar dropdown)
  2. Select a .json file containing exported commands
  3. Review the import preview
  4. Click Import

Conflict Handling: If a command with the same name already exists:

  • Skip: Keep your existing command
  • Replace: Overwrite with the imported version
  • Rename: Import as a new command with "(2)" suffix

Space Import/Export

Spaces are exported as ZIP packages because they contain both metadata and file contents.

What Gets Exported

A Space export includes:

ComponentDescription
Space MetadataName, description, emoji, color, token budget
SpaceData ItemsAll files and text blocks in the Space
File ContentsThe actual extracted text from each document
Token CountsPreserved token usage for each item
Compaction StatusWhether items are raw or compacted

Exporting Spaces

  1. Open Dashboard > Spaces
  2. (Optional) Select specific Spaces
  3. Click the Export/Import dropdown in the toolbar
  4. Choose Export Selected or Export All
  5. Save as .zip
┌─────────────────────────────────────────────────────────────────────────┐
│ SPACES TOOLBAR │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ [+ New Space] [Search...] [Show Archived] [Export/Import ▼] │
│ ┌──────────────────────┐ │
│ │ Export Selected │ │
│ │ Export All │ │
│ │ ───────────────── │ │
│ │ Import Spaces │ │
│ └──────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘

Importing Spaces

  1. Click the Export/Import dropdown in the Spaces toolbar
  2. Choose Import Spaces
  3. Select the .zip file
  4. Review the Spaces and files to be imported
  5. Click Import

Conflict Handling: Similar to commands, if a Space with the same name exists:

  • Skip: Keep existing Space
  • Replace: Overwrite with imported data
  • Rename: Create as a new Space with modified name

History Export

Transaction history can be exported for record-keeping, analysis, or compliance purposes.

Exporting History to CSV

  1. Open Dashboard > History
  2. (Optional) Filter by date range, command, or provider
  3. Click Export CSV in the toolbar
  4. Choose a location and save

CSV Contents

The exported CSV includes:

ColumnDescription
TimestampWhen the command was executed
Command NameWhich command was used
ProviderAI provider (OpenAI, Anthropic, etc.)
ModelSpecific model used
Input TextThe text that was processed
Output TextThe AI's response
Tokens InInput token count
Tokens OutOutput token count
StatusSuccess, Error, or Cancelled

Note: History export is one-way only. You cannot import history back into Rephlo.


Common Use Cases

1. Backup Before Reinstalling

Before reinstalling Windows or Rephlo:

  1. Export all commands to commands-backup.json
  2. Export all spaces to spaces-backup.zip
  3. Export history to history-backup.csv
  4. Note your API keys from Settings
  5. Store backups in cloud or external drive

2. Share Commands with Team Members

You have created useful commands for your team:

  1. Export your commands as JSON
  2. Share the file via email, Slack, or shared drive
  3. Team members import into their Rephlo instances
  4. Everyone benefits from the same optimized prompts

3. Move Configuration to New Computer

Setting up Rephlo on a new machine:

  1. On old computer: Export all commands and spaces
  2. Transfer files to new computer
  3. Install Rephlo on new computer
  4. Import commands and spaces
  5. Configure API keys in Settings

4. Version Control for Command Libraries

For teams managing large command sets:

  1. Export commands regularly (e.g., weekly)
  2. Store JSON files in a Git repository
  3. Track changes over time
  4. Roll back to previous versions if needed

Access Locations Summary

FeatureLocation
Command Export/ImportFile menu > Export/Import Commands, or Commands view toolbar
Space Export/ImportSpaces view toolbar > Export/Import dropdown
History ExportHistory view > Export CSV button

Best Practices

  1. Regular Backups: Export your commands and spaces monthly, or before major changes
  2. Descriptive Filenames: Use names like commands-2025-01-15.json for easy identification
  3. Organize Backups: Keep a dedicated folder for Rephlo backups
  4. Test Imports: After importing, verify a few commands work as expected
  5. Share Responsibly: Review commands before sharing to ensure no sensitive information is included

Next Section: Configure Rephlo to your preferences in Settings.