AI debugging for physical systems. Capture live logs and telemetry and get evidence-grounded answers.
Gimble is a free, open-source CLI for debugging physical systems. It captures terminal and log context, ingests live telemetry and system state—so engineers can get answers grounded in real events and fix issues faster without digging through thousands of log lines.
- Capture live terminal and log context as you work
- Open a live browser session you can share
- Get answers with evidence, not hallucinations or guesswork
Install (Linux + macOS):
curl -fsSL https://raw.githubusercontent.com/gimbleHQ/Gimble-dev/main/scripts/install_latest.sh | bashThen finish first-time setup (the installer or gimble setup will guide you).
Gimble setup requires accepting the data/privacy policy. See /docs/privacy_policy.md.
Start a session (normal terminal):
gimbleCloud chat + log upload (run inside that session):
gim chatGimble CLI connects to a hosted Gimble Cloud companion that powers chat and evidence retrieval.
- The CLI captures session activity and uploads sanitized logs.
- Gimble Cloud turns that context into a live, queryable and shareable browser session.
- Every answer is grounded with evidence from your session history.
Commands depend on where you run them: your normal shell (gimble …) vs inside an active Gimble session (gim …).
| Command | What it does |
|---|---|
gimble / gimble session |
Start a Gimble shell session |
gimble --version |
Print the installed version |
gimble setup |
Run the first-time setup wizard |
gimble keys |
Set OpenAI, Groq, or Nebius API keys |
gimble profile |
Show the active profile; use gimble profile <subcommand> to create, switch, or edit profiles |
| Command | What it does |
|---|---|
gim chat |
Start Gimble Cloud chat and the log uploader |
gim keys |
Update API keys without leaving the session |
gim profile |
Show the active profile |
gim exit |
Stop the uploader and leave the session |
Full syntax (especially profiles), flags, and examples: command reference. Use gimble --help for the exact text your build ships with.
| Doc | Contents |
|---|---|
| Command reference | All commands, profile subcommands, examples |
| Environment & local config | Config paths, chat.env, proxies, logs |
| Troubleshooting | PATH, permissions, Homebrew, APT, network |
We welcome contributions. Please read the Contributing Guide and Code of Conduct before getting started.
We love support from the community and appreciate you taking the time to try Gimble — thank you.
This is a passion project born out of our frustration with unreliable physical systems, and we’re trying our best to keep it free and open-source for everyone. We currently cover the compute costs ourselves and rely on free-tier cloud resources, so heavy usage can occasionally trigger rate limits. If that happens, please reach out to us here — we’d love to discuss and figure out a way to support your use case.
Email: gimble256@gmail.com
Regards, S & R.