G-Watch CLI

G-Watch CLI is a tool for running agentic GPU profiling and optimization using G-Watch.

Features

• Workspace Management: Clone remote repos or map local directories.
• Environment Automation: Automatically installs Node.js, Tmux, and @google/gemini-cli inside the container.
• Session Management: Wraps Tmux sessions for persistent development.
• Easy Access: Simple commands to create, enter, list, and stop environments.

Installation

Install globally via npm:

npm install -g @gwatch/gwatch-cli

Alternatively, to install from source:

git clone https://github.com/G-Watch/gwatch-cli.git
cd Watchtower
npm install -g .

Usage

1. Create a container from a remote git repo

gwatch-cli start --repo https://github.com/user/project.git --dockerfile ./Dockerfile

2. Create a container from current local directory

gwatch-cli start --dir . --dockerfile ./Dockerfile

3. Enter a container/session

# Enter container 0, default session
gwatch-cli enter 0

# Enter container 0, specific session (creates if not exists)
gwatch-cli enter 0/debug_sass

4. List status

gwatch-cli ls

5. Stop commands

# Stops the Docker Container
gwatch-cli stop 0

# Kills only the specific tmux session inside the container
gwatch-cli stop 0/debug_sass

Internal Database

Metadata is stored in ~/.watchtower/db.json.