Petacomm Petacomm
Use Cases Support GitHub LinkedIn All Petacomm
petacomm.io › User Tools

Tools built for
Linux users

PetaShell, PetaFiles and PetaSync — a trio of productivity tools for developers and system administrators. Reinvent your terminal, file manager and configuration sync, all under one unified peta CLI.

PetaShell PetaFiles ›
PetaShell PetaFiles PetaSync Compare Setup Guide Documentation
User Tools v3.4 — PetaShell now includes git-aware prompt and inline AI suggestions via Petacomm Easy. What's new →
3Tools Included
1Unified CLI
18+Distros Supported
GPL‑3Open Source

Three tools.
One workflow.

Everything a Linux power user needs — without the bloat.

Petacomm User Tools are designed to work together seamlessly. PetaShell gives you a smarter terminal, PetaFiles gives you a fast keyboard-driven file manager you can launch without leaving the shell, and PetaSync keeps your configuration identical across every machine you use.

All three tools are managed through the single peta CLI and install as zero-dependency binaries in under three minutes.

  • Single binary per tool — no runtime dependencies
  • All three tools managed from one peta CLI entry point
  • Shared configuration directory at ~/.config/petacomm/
  • Works in SSH sessions, tmux, screen and local terminals
  • Compatible with bash, zsh, fish and POSIX shells
Install User Tools Full Documentation ›
peta — unified CLI
# Check all user tools
peta@workstation:~$ peta status

● petashell active shell: zsh integration
● petafiles active preview: enabled
● petasync active last sync: 2m ago

# Launch file manager from within PetaShell
→ ~/projects $ pf
[PetaFiles opens in-terminal]

# Push dotfiles to all machines
→ ~/projects $ petasync push --all
✓ Synced to 3 machines in 1.2s

→ ~/projects $

PetaShell

A smarter terminal experience for Linux power users.

PetaShell enhances your existing shell with intelligent features — without replacing it. It layers on top of bash, zsh or fish and adds context-aware command completion, a git-aware prompt, syntax highlighting and inline AI suggestions powered by Petacomm Easy.

Installation adds a single line to your shell rc file. Remove it at any time to go back to your original shell with no side effects.

  • Context-aware command completion — flags, file paths, git branches
  • Syntax highlighting as you type — invalid commands shown in red
  • Git-aware prompt — branch, dirty state, ahead/behind indicators
  • Command history search with fuzzy matching (Ctrl+R)
  • Inline AI suggestions via Petacomm Easy integration
  • Auto-suggestions from your personal command history
  • Multi-line paste protection — shows preview before pasting
  • Plugin system — extend with community or custom plugins
Take A Tour Documentation ›
petashell — zsh integration
# Git-aware prompt
petacomm main +2 ~1 ~/projects/api $

# Syntax highlighting as you type
petacomm main ~/projects $ git commit -m "fix: resolve memory leak"

# Context-aware completion
petacomm main ~/projects $ docker [tab]
build compose container exec image
inspect logs network ps pull

# Inline AI suggestion (press → to accept)
petacomm main ~/projects $ find . -name "*.log" -mtime +7 -delete

petacomm main ~/projects $
PetaShell

Works with your
existing shell

No migration. No learning curve. Just better.

PetaShell is not a new shell — it is an enhancement layer that works with bash, zsh and fish. Your existing aliases, functions and history are preserved. Uninstall at any time with a single command and your shell returns to its original state.

Essential keyboard shortcuts

Shortcut Action
Ctrl+R Fuzzy search through command history
→ or Tab Accept inline AI or history suggestion
Ctrl+Space Open AI command suggestion panel
Alt+. Insert last argument of previous command
Ctrl+T Fuzzy search files in current directory
Ctrl+G Open PetaFiles in current directory
pf Launch PetaFiles (alias)
Of Course Open Source Contact Us ›
Smart Completion
Understands flags, subcommands, file paths, environment variables and git branch names in context.
Syntax Highlighting
Valid commands highlighted in green, invalid in red, flags in blue — as you type, before you run.
Git-Aware Prompt
Branch name, staged files, unstaged changes and ahead/behind count visible at a glance in your prompt.
AI Suggestions
Press Ctrl+Space to ask Petacomm Easy for a command suggestion based on what you are trying to do.
History Search
Fuzzy search your entire command history with real-time preview. Find any command you've run before in seconds.
Plugin System
Extend PetaShell with community plugins or write your own. Compatible with Oh My Zsh and Prezto plugins.

PetaFiles

A keyboard-driven terminal file manager built for speed.

PetaFiles is a lightweight terminal file manager inspired by vim and ranger. Navigate your filesystem at the speed of thought using keyboard shortcuts, with a split-pane layout, file preview panel and full network filesystem support — all without leaving the terminal.

Launch it from PetaShell with pf or Ctrl+G — it opens in your current directory and closes back to the shell when you press q.

  • Vim-style navigation — hjkl to move, Enter to open
  • Three-pane layout — parent / current / preview
  • File preview — text, images, archives, PDFs
  • NFS, SMB and SSHFS network filesystem support
  • Bulk rename with regex and editor-based rename
  • Bookmarks — jump to frequent directories instantly
  • Integration with your default editor ($EDITOR)
  • File permissions, owner and size shown in status bar
Take A Tour Documentation ›
petafiles — ~/projects
petacomm/ │ server-tools/ │ README.md
api/ │ user-tools/ │
docs/ │ security/ │ # Petacomm
scripts/ │ setup/ │# User Tools
▶ server-tools/ │ docs/ │#
infra/ │▶README.md │# PetaShell
.config/ │ package.json │# PetaFiles
│ tsconfig.json │# PetaSync

─────────────────────────────────────────────
README.md 4.2K rw-r--r-- 2026-04-28 q:quit /:search m:bookmark
Startup Time vs Alternatives
PetaFiles
0.04s
ranger
0.72s
nnn
0.09s
PetaFiles

Navigate at
keyboard speed

No mouse. No menus. Pure keyboard control.

Every action in PetaFiles has a keyboard shortcut. The layout is intentionally minimal — three panes, a status bar, and nothing else. Everything you need to manage files is one or two keystrokes away.

Core keyboard shortcuts

Key Action
h j k l Navigate — parent / down / up / open
Enter Open file or enter directory
Space Select / deselect file
y p d Copy / paste / delete selected
r Rename file
R Bulk rename selected files in editor
m Bookmark current directory
' Jump to bookmark
/ Search files in current directory
e Open file in $EDITOR
q Quit and return to shell at current directory
Of Course Open Source Contact Us ›
Three-Pane Layout
Parent directory, current directory and file preview — all visible at once. Resize panes to suit your workflow.
File Preview
Text files, code, images, PDFs and archive contents previewed inline in the third pane — no external viewer needed.
Network FS
Browse NFS, SMB and SSHFS mounts exactly like local directories. Permissions and ownership displayed correctly.
Bulk Rename
Select multiple files and rename them all at once using regex substitution or an editor-based list rename.
Bookmarks
Bookmark frequently visited directories and jump to them instantly with ' followed by the bookmark key.
Fuzzy Search
Press / to search filenames in the current directory tree with instant fuzzy matching and live highlighting.

PetaSync

Keep your dotfiles and config identical across every machine.

PetaSync solves the problem every developer has — your shell aliases, editor config and tool preferences are on one machine but not another. It synchronises your chosen dotfiles and configuration directories between any number of machines over SSH, encrypted in transit, with instant bidirectional updates.

Works without a central server. PetaSync connects your machines directly peer-to-peer over SSH. Your configuration data never passes through a third-party service.

  • SSH-encrypted direct machine-to-machine sync
  • Bidirectional — push and pull from any machine
  • Granular file selection — sync only what you choose
  • Conflict detection with interactive resolution
  • Scheduled automatic sync via cron or daemon mode
  • No central server — peer-to-peer, your data stays yours
  • Backup mode — sync to NAS or S3-compatible storage
  • Dry-run mode — preview changes before applying
Take A Tour Documentation ›
petasync — config sync
# Add machines to sync with
user@laptop:~$ petasync add workstation [email protected]
✓ workstation added (ssh key: accepted)

# Define what to sync
user@laptop:~$ petasync track ~/.zshrc ~/.config/nvim ~/.config/petacomm
✓ 3 paths added to sync manifest

# Push to all machines
user@laptop:~$ petasync push --all
→ workstation .zshrc sent 2.1K
→ workstation nvim/init.lua sent 8.4K
→ workstation petacomm/ sent 1.2K
✓ Synced to 1 machine in 0.8s

# Enable automatic sync every 5 minutes
user@laptop:~$ petasync daemon --interval 5m
✓ Daemon running. Watching for changes.

user@laptop:~$
PetaSync

Your config.
Every machine.

Peer-to-peer. Encrypted. Always in sync.

PetaSync is intentionally simple. Add machines, choose what to sync, and run petasync push --all. That's it. Enable the daemon for automatic sync and you'll never have to think about it again.

What to sync

Common files to track with PetaSync: ~/.zshrc, ~/.bashrc, ~/.config/nvim/, ~/.ssh/config (not keys), ~/.config/petacomm/, git global config and any tool-specific dotfiles.

Full sync guide ›
Of Course Open Source Contact Us ›
SSH Encrypted
All sync traffic is encrypted over SSH. No third-party service, no cloud account — direct machine to machine.
Bidirectional
Push from any machine, pull to any machine. All machines stay in sync regardless of which one you made changes on.
Daemon Mode
Run petasync daemon to watch for file changes and sync automatically at a configurable interval.
Conflict Detection
When the same file is changed on two machines, PetaSync detects the conflict and shows a diff for interactive resolution.
Backup Mode
Sync your dotfiles to a NAS, Hetzner Storage Box or any S3-compatible storage as an off-site backup.
Dry-run Mode
Preview exactly which files would be created, updated or deleted before committing any changes to disk.

All three user tools at a glance

Install individually or together — all included in the standard Petacomm package.

Feature PetaShell PetaFiles PetaSync
Primary purpose Enhanced terminal shell Terminal file manager Config synchronisation
Launch command peta shell pf petasync
Memory usage ~6 MB ~4 MB ~3 MB (daemon)
Keyboard-driven ✓ ✓ ✓
AI integration ✓ Inline suggestions — —
Network FS support — ✓ NFS, SMB, SSHFS ✓ SSH peer-to-peer
File preview — ✓ Text, images, archives —
Daemon / background mode — — ✓
Plugin support ✓ bash/zsh/fish plugins — —
peta CLI integration ✓ ✓ ✓
GPL-3.0 open source ✓ ✓ ✓
Install all three with one command
All user tools are included in the standard Petacomm package. Install once with the Easy installer and all three are immediately available.
Setup Guide

Works on every major Linux distribution

All user tools are tested across 18+ Linux distributions. Same binaries, same behaviour.

Ubuntu Debian Arch Alpine RHEL Fedora openSUSE +11 more

Ready to improve your workflow?

Install all three user tools in under three minutes. No configuration required to get started.

Setup Guide Documentation