A Command-Line Power Utility by Fossil Logic #
Shark Tool is an all-in-one file and system administration utility designed for admins, developers, and power users. It consolidates essential file management, automation, and analysis capabilities into a single unified command-line interface, reducing tool fragmentation and improving workflow efficiency.
It introduces advanced, domain-specific commands such as grammar for AI-powered text analysis, introspect for deep file inspection, and cryptic for encoding and decoding operations—features typically spread across multiple standalone utilities.
Features #
Shark Tool provides a comprehensive suite of system and file operations:
- Comprehensive file and directory operations including show, copy, move, delete, rename, and create
- Archive management with support for zip, tar, gz, including encryption
- Advanced search capabilities with recursive content and filename filtering
- Metadata and timestamp control with permissions and attribute handling
- Cross-platform support for Linux, macOS, and Windows
- AI-powered text analysis via SOAP-based grammar and style services
- File synchronization with intelligent diff-based updates
- Real-time file system monitoring with event filtering
- Multi-cipher encoding and decoding (Base64, Caesar, Vigenère, ROT13, etc.)
- File comparison with structured diff analysis and inspection tools
Why Choose Shark Tool? #
Unlike traditional CLI utilities that require multiple separate tools, Shark Tool provides a unified interface for system operations.
Key Advantages #
- All-in-One Solution
Replace fragmented toolchains with a single consistent CLI. - Advanced Command Set
Unique commands likegrammar,introspect, andcrypticextend beyond traditional system tools. - Developer-Focused Design
Built for performance, scripting, and automation workflows. - Cross-Platform Consistency
Works seamlessly across Linux, macOS, and Windows environments. - Intelligent Defaults
Smart handling of timestamps, permissions, and metadata with optional fine-grained control. - Modern Build System
Built using the Meson build system for speed and maintainability.
Prerequisites #
Before building Shark Tool, ensure the following is installed:
- Meson Build System
Setting Up Meson Build #
Install Meson #
Follow the official installation instructions for your operating system via the Meson documentation.
Building and Installing Shark Tool #
Clone the Repository #
git clone https://github.com/fossillogic/shark.git
cd shark
Configure Build #
meson setup builddir
Compile Project #
meson compile -C builddir
Install Project #
meson install -C builddir
Run Shark Tool #
shark --help
Command Palette #
Core File Operations #
| Command | Description | Flags |
|---|---|---|
| show | Display files and directories | -a, -l, -h, -r, -d, –as, –time, -s, -m, –size, -t |
| merge | Combine files or directories | -f, -i, -b, –strategy, –progress, –dry-run |
| swap | Exchange file locations | -f, -i, -b, –atomic, –progress |
| move | Move or rename files | -f, -i, -b, –atomic, –progress |
| copy | Copy files or directories | -r, -u, -p, –checksum, –reflink, –progress |
| remove / delete | Delete files or directories | -r, -f, -i, –trash, –wipe, –shred |
| rename | Rename files or directories | -f, -i |
| create | Create files or directories | -p, -t |
| search | Find files by name or content | -r, -n, -c, -i |
| archive | Archive operations | -c, -x, -l, -f, -p |
| compare | Compare files or directories | -t, -b, –context, –ignore-case |
| help | Show help | –examples, –man |
| sync | Synchronize files | -r, -u, –delete |
| watch | Monitor filesystem changes | -r, -e, -t |
| rewrite | Modify file content or metadata | -a, –in-place |
| introspect | Inspect file structure and metadata | –head, –tail, –type, –size |
| grammar | AI grammar and style analysis | –check, –correct, –tone, –score |
| cryptic | Encode/decode text | -e, -d, -c |
| split | Split files into segments | -l, -b, -n |
Global Flags #
| Flag | Description |
|---|---|
| –help | Show command help |
| –version | Display version |
| -v, –verbose | Verbose output |
| -q, –quiet | Suppress output |
| –dry-run | Simulate actions |
| –color | Enable colored output |
| –time | Show timestamps |
Usage Examples #
shark show -a -l -h --as=tree --time
shark merge -i -b src1/ src2/ dest/
shark swap -f -b file1.txt file2.txt
shark move -i -b old.txt archive/old.txt
shark copy -r -p src/ backup/
shark remove -r --trash temp/
shark rename -i draft.md final.md
shark create -p -t dir logs/archive/
shark search -r -c "config"
shark archive -c -f tar project.tar src/
shark compare -t main.c old.c --context 5
shark sync -ru src/ dest/
shark watch -r -e create,delete src/
shark rewrite -a --in-place log.txt "entry"
shark introspect --head 20 --tail 5 file.txt
shark grammar --check --tone --score notes.txt
shark cryptic -e -c caesar "hello"
shark split -l 100 -p chunk_ file.txt
Command Comparison #
Shark Tool replaces multiple traditional utilities with a unified interface:
| Shark Command | Traditional Tools | Purpose |
|---|---|---|
| show | ls, tree, stat | File listing and metadata |
| merge | cp, rsync | Directory merging |
| swap | mv (manual logic) | Atomic file swapping |
| move | mv | File relocation |
| copy | cp | File copying with verification |
| remove | rm, shred | Safe deletion and wiping |
| search | find, grep | File and content search |
| archive | tar, zip | Archive management |
| compare | diff, cmp | File comparison |
| sync | rsync | Directory synchronization |
| watch | inotifywait | File system monitoring |
| rewrite | sed, truncate | File modification |
| introspect | head, tail, stat | File inspection |
| grammar | external AI tools | Text analysis |
| cryptic | encoding tools | Cipher operations |
| split | split | File segmentation |
Summary #
Shark Tool is designed as a modern, unified command-line system for file management, automation, and analysis. By combining traditional UNIX-style utilities with advanced inspection, AI-assisted text processing, and secure data handling, it provides a powerful and extensible environment for professional workflows.
Built by Fossil Logic using the Meson Build System, Shark Tool emphasizes performance, consistency, and developer productivity.
