Skip to content

throughwalls/throughwalls-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Throughwalls

Website · Documentation · Watch Demo

Overview

Beta Notice. Throughwalls is currently in beta. It is usable, but bugs, unexpected behavior, and breaking changes may occur. Please do not use Throughwalls as the only place to store important data or for critical production workloads. Keep your own backups outside of Throughwalls.

AI can make working with a computer dramatically easier. Instead of spending a long time learning many different tools, you can ask an AI agent to do what you need. But giving an AI agent full control over a computer is risky. If it hallucinates or misunderstands the prompt, it may delete important files or change the computer state into something you did not want. Throughwalls solves this problem.

Snapshots

Throughwalls is a system that lets you save the state of the computer you work in. These saved states are called snapshots. Each snapshot contains all information that existed on the computer when the snapshot was created, including files. If an AI agent deletes information you need, you can instantly roll back to any snapshot and either continue working from that point or recover the files you need before returning to the state where you noticed the mistake.

Seamless Switching

Thanks to the CLI, this whole process happens seamlessly in the terminal where you are connected to the Workspace. In one terminal window, you connect to the Workspace with throughwalls connect. In another terminal window, you create snapshots and move between them with throughwalls snap create and throughwalls goto. When you switch to another snapshot, the terminal where you ran throughwalls connect starts reconnecting to the new Workspace, which will be in the state of the selected snapshot.

How the CLI Works

Throughwalls goto workflow

Workspace is a virtual machine that runs on top of the host. The CLI sends requests to the host. The host manages the whole process of creating snapshots and switching between them. That is why, before using the CLI, you first need to log in with throughwalls host login.

Before You Start

The CLI manages Throughwalls installed on a server. Before using the CLI, install the system first.

See the installation guide.

Install the CLI

After Throughwalls is installed on your server, install the CLI on your local machine.

Homebrew

brew install throughwalls/tap/throughwalls-cli

GitHub Releases

Download a prebuilt binary for your OS from GitHub Releases.

Quick Start

throughwalls host login --host-password <password-entered-during-server-installation>

throughwalls connect --ip <server-ip> --workspace-username username --workspace-password <password-entered-during-server-installation>

throughwalls snap create

throughwalls line

throughwalls goto <snapshot-id>

Full beginner guide here.

Development

Run tests:

make test

Build locally:

make build

Check the local binary:

./bin/throughwalls --help

License

Licensed under the Apache License 2.0.

About

Create snapshots and switch between them for safer AI-assisted computer work.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors