Skip to main content

Keep your machine's shell history synchronized.

Project description

SyncShell

MIT License Build Status PyPi PyPi

SyncShell as a simple and secure tool allows to synchronize machine's shell history across devices. It's built on top of Github Gist and written in Python (CLI). With SyncShell, you no longer have to worry about manually syncing your office and home machine's shell history and let continue where the terminal session left.

Features

  • Sync your shell history across all your devices
  • Securely store your shell history on Github Gist
  • Support for zsh and bash shells
  • Easy to install and use

Installation

To install SyncShell, simply run the following command:

$ pip install syncshell

Usage

To use SyncShell, It first needs to set up a Github token key by following these steps:

  1. Open Github personal access tokens page, Generate a new token with gist scope feature.
  2. Execute the syncshell auth command, Enter the token key to validate and confirm it.

Once finished, try to upload shell history by the following command:

$ syncshell upload

After uploading, the download command lets to sync and pull changes on the other machines:

$ syncshell download

Synopsis

$ syncshell
Type:        Application
String form: <syncshell.cli.Application object at 0x101b1ff10>
Docstring:   SyncShell CLI Application

Usage:       syncshell 
             syncshell auth
             syncshell download
             syncshell upload

How it Works

SyncShell is a tool that synchronizes shell history across all devices by securely storing the history file on Github Gist. Github Gist provides two types of Gists, public and secret. When the syncshell upload command is executed, the shell history file is uploaded and stored securely on Github Gist as a secret Gist. To download the uploaded shell history on other devices, the syncshell download command is used. This command retrieves the previously uploaded Gist, allowing the user to access their shell history on any device.

Security: A Gist will be secret until it's not shared and will be secret and safe until you only have the Github Token and Gist ID.

Privacy: In case of having password or secret in a history file, Its suggested to first have a alignment with privacy policies for any usecase.

Contributing

Appreciate the contribution to this repository.

To contribute, you need to follow the below steps for suggesting a change or a new feature:

  1. Install poetry as a dependency manager
  2. Install dependencies by running poetry install
  3. Make your changes
  4. Run and debug your changes by running poetry run python syncshell
  5. Run tests by running poetry run pytest -c pytest.ini -s
  6. Submit a pull request

License

The code is licensed under the MIT License. See the data's LICENSE file for more information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

syncshell-1.0.6.tar.gz (6.5 kB view hashes)

Uploaded Source

Built Distribution

syncshell-1.0.6-py3-none-any.whl (8.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page