Skip to main content

RepOS - REPL-driven developer operating system

Project description

RepOS (repos-cli)

RepOS is a multi-panel, REPL-based command environment that runs inside your terminal. It acts as a lightweight “operating layer” on top of your shell, letting you organize commands into panels (Git, OS, Python, Docker, etc.), store aliases persistently, and move between contexts without shell scripts or dotfile sprawl. This package installs the RepOS CLI.


Installation

pip install repos-cli

Python 3.10+ required.


Usage

Start RepOS:

repos-cli

You’ll enter the root REP panel.

Create project level database:

repos-cli init

You’ll enter the root REP panel. This takes no other arguments and will create a .repos file in the current directory.

Exit at any time with:

ZZ

What RepOS Does

  • Provides a panel-based REPL inside your terminal
  • Stores aliases persistently using SQLite
  • Executes real shell commands (not simulations)
  • Tracks command history and execution results
  • Uses YAML configuration for system and panel defaults RepOS is not a shell and does not replace Bash/Zsh — it runs on top of your existing shell.

Configuration & Defaults

On first run, RepOS initializes a local data directory under:

~/.local/share/repos/

This includes:

  • a core SQLite database
  • default panel definitions (Git, OS, Python, Node, Docker, etc.)
  • system configuration loaded from packaged YAML defaults You can customize panels and aliases from inside RepOS itself.

Project Status

This is an early-stage release focused on establishing the core REPL, execution engine, and persistence model. The interface and internal architecture are still evolving.


Licensing

RepOS is licensed under the Business Source License 1.1 (BSL 1.1).

  • Free for personal use and internal development
  • Not permitted to be sold or offered as a hosted service before the Change Date
  • Automatically converts to Apache License 2.0 on January 1, 2029 See:
  • LICENSE
  • NOTICE
  • legal/ directory for commercial licensing and contribution terms RepOS™ and TriFactoria™ are trademarks of Andrew Blankfield.

Support

If you find RepOS useful and would like to support its continued development, donations are welcome. GitHub Sponsors: https://github.com/sponsors/trifactoria

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

repos_cli-0.0.3.tar.gz (77.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

repos_cli-0.0.3-py3-none-any.whl (50.6 kB view details)

Uploaded Python 3

File details

Details for the file repos_cli-0.0.3.tar.gz.

File metadata

  • Download URL: repos_cli-0.0.3.tar.gz
  • Upload date:
  • Size: 77.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for repos_cli-0.0.3.tar.gz
Algorithm Hash digest
SHA256 9cf2285078a4e35b326930a02ea00d48e3ad5e870af44b8777d36675f94e0534
MD5 643c38b0c9318d17923455ed28df9b90
BLAKE2b-256 c6b62ce923f1fe8e9988150db2e840bb21b4cd22932e5f56ad1bdb465ef6aca6

See more details on using hashes here.

Provenance

The following attestation bundles were made for repos_cli-0.0.3.tar.gz:

Publisher: publish.yml on trifactoria/repos-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file repos_cli-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: repos_cli-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 50.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for repos_cli-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 ac83531aae3545b0ad8ad98ea21175fde6b1cd8bf660130f56245f07d929142b
MD5 45a01a804b9fc3368bb5e06d24fc1519
BLAKE2b-256 5075afadb85e2bdd08b37695124cc37215d961754a82d76eb7c2e5b797fb2b3b

See more details on using hashes here.

Provenance

The following attestation bundles were made for repos_cli-0.0.3-py3-none-any.whl:

Publisher: publish.yml on trifactoria/repos-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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