← Docs

Terminal and GitHub

Tamo's own Linux terminal with git and the GitHub CLI. It clones your repo, runs tests in the background, pushes a fix and opens a pull request.

Tamo has its own Linux terminal, just for you. It comes with git and the GitHub CLI, and whatever Tamo installs or logs in to stays there for next time.

Me: The tests on my shop repo are failing since yesterday. Can you fix it and open a PR?14:30 ✓✓
Tamo: Cloned it and started the tests in my terminal. I'll tell you when they finish.14:31
Tamo: ⚙️ Finished in my terminal: #1 npm test: exited 1 after 4m51s14:36
Tamo: A date test assumed UTC. I fixed it, the tests pass now, and I opened a pull request: "Fix timezone in order date test".14:39

Signing in to GitHub

Ask Tamo to log in to GitHub. It starts GitHub’s own sign-in and either finishes it in its browser, handing it to you to sign in to the right account, or sends you GitHub’s link and code to open yourself. Whichever account is signed in when the code is entered is the one Tamo uses. It never asks for your GitHub password or token, and tokens printed in the terminal are hidden from the AI.

Background jobs

Builds, test runs, installs and servers can run in the background while Tamo carries on talking to you. When one finishes you get a message:

Tamo: ⚙️ Finished in my terminal: #2 npm run build: exited 0 after 3m12s

Up to 3 background jobs run at a time, each for up to an hour. Quick commands are given a couple of minutes. /stop ends the task and anything running in the terminal.

What asks first

Some commands always wait for your yes. Tamo says what the command does and shows it to you: force-pushing or deleting on a remote, changing your GitHub repositories or settings, posting on GitHub as you, publishing a package, and deleting whole folders.

Tamo: I'm about to run this in my terminal. It publishes a package: npm publish Allow?
Yes, do itNo

Once Tamo has read a web page, a file or a command’s output during a task, it asks before every further command, because text it read could try to steer it. You can answer Yes, for this whole task to stop the questions until the task is done.

The terminal can install from GitHub and the usual package registries (npm, pip, Go, Rust) on its own. Any other site it wants to reach is asked about like a new site in the browser.

Good to know

  • Files you send to Tamo land in its terminal, so it can work with them.
  • Tamo has no admin rights on its computer. It installs tools into its own home folder.
  • A Tamo update stops jobs that were running in the background. Ask again if one was cut short.