Free kit ยท Linux, Mac and VPS

Your team of bots, through your subscription

A dashboard with bots that have a role, memory and scheduled tasks. The replies come from your Claude or Codex login, with no API key.

Time de Bots banner: your bots through your subscription, on your computer or on a VPS
In short

Time de Bots ("Team of Bots" in Portuguese) is a free INEMA kit that installs a bot dashboard on your Linux or Mac computer, or on a VPS (a server you rent on the internet). Each bot has a name, avatar, role, memory and scheduled tasks, and you chat with one at a time or with several in a group. The replies come from your Claude or Codex subscription, through the normal login of the official program, with no API key and no pay-per-use billing. You need Node.js 22 or newer and a Claude account or a ChatGPT account with Codex.

Video

Video: Time de Bots in 3 min

Your team of bots on the subscription you already pay for: what each bot does, the 3 ways to use it, the tests from Nov 9, 2026 and the step by step. Audio in Portuguese.

Watch on YouTube

What it is

A bot app + a kit that installs, checks and starts it

The bot app is a desktop program (built with Electron, MIT license). The INEMA kit gets that app running the right way: it installs it, runs the tests, opens several teams and sets up server mode.

Bots with a role, memory, scheduled tasks, group chat, several teams and a VPS over an SSH tunnel

๐Ÿ”‘ Only your subscription

The app only accepts the Claude Code claude.ai login or the Codex login. kit/iniciar.sh removes the API keys from the environment before opening.

๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘ Bots with a role

Each bot has a name, avatar, instructions, memory and scheduled tasks. Chat with one or call several together in a group.

๐Ÿ—‚๏ธ Several teams

Each instance is a separate team, with its own bots, chats and memory. E.g.: a personal one and a work one on the same machine.

How it works

From your subscription to the bot group

You log in to your account once, in the terminal. The app uses that login to reply. The bots live in the dashboard, chat on their own or in a group and run tasks at the scheduled time.

Your Claude or Codex subscriptionโ†’ Login in the terminal (claude / codex login)โ†’ Time de Bots appโ†’ Bots ยท group ยท schedule

๐Ÿ’ป On your computer

The app opens in a window, like any program. Each team's data lives in ~/.local/share/time-de-bots/<instance>.

๐Ÿ–ฅ๏ธ On a VPS, over an SSH tunnel

The server creates a virtual screen and shows the app in the browser (noVNC), all bound to 127.0.0.1. You open an SSH tunnel from your computer and go to http://localhost:6081/vnc.html. No port is left open to the internet.

3 ways to use it

Choose where your team will live

You can start on your computer and move to the VPS later. All three use the same kit.

๐Ÿ’ป On your computer

Linux or Mac, for those who want the bots at hand. Tested on Linux; the Mac has not been tested yet.

kit/iniciar.sh

๐Ÿ—‚๏ธ Another team on the same machine

To separate personal and work, or one team per client.

kit/iniciar.sh --instancia trabalho

๐Ÿ–ฅ๏ธ On a VPS

Bots and scheduled tasks running 24/7, reachable from anywhere.

kit/vps/nova-instancia.sh principal 1
Prerequisites

What you need first

kit/instalar.sh checks all of this and tells you what is missing.

Node.js 22+ and npm

Download it from nodejs.org. Check the version:

node --version   # v22 or newer

Claude Code or Codex

A Claude account (subscription) or a ChatGPT account with Codex, and the official program installed. Claude Code: installation guide.

npm i -g @openai/codex   # if you will use Codex

Git

To download the kit and update it later. On the VPS: Ubuntu 24.04 or newer and a regular user with sudo (not root).

git --version
User guide ยท step by step

From zero to your first bot

Real kit commands. Run them in the terminal, in the kit folder. Would you rather have the assistant do it for you? Skip to the ready-made prompts.

On your computer

1

Download the kit

Downloads the repository and enters the folder.

git clone https://github.com/inematds/time-de-bots.git && cd time-de-bots
2

Install and run the tests

Checks Node and npm, installs the dependencies, downloads the app files (verified by checksum) and runs the 193 tests. It doesn't log in to any account.

kit/instalar.sh   # at the end: "[ok]  193 testes passaram"
3

Log in to your account (once)

You do the login yourself in the terminal. The claude command opens Claude Code: the first time, it asks you to sign in to your account; once signed in, leave with /exit. Don't have Claude Code yet? See the installation guide. Use one of the two:

claude         # log in with your Claude account
codex login    # or log in with your Codex account
4

Check a real reply

Uses the same code as the app and the Claude Code login to ask for a real reply (haiku model, the lightest one). Saves the result in kit/verificacao/ultima-resposta.json. This test is for Claude only.

node kit/scripts/conferir-resposta.mjs   # "Login do Claude: OK (assinatura claude.ai)"
5

Open the app

Opens the "principal" instance. On Linux, if you see the sandbox-disabled warning, the app works anyway; see how to enable it in COMO-LIGAR-SANDBOX.md (in Portuguese).

kit/iniciar.sh
6

Choose the provider and create your first bot

In the app, go to Settings โ†’ AI subscription, choose Claude or Codex and create your first bot with the + button. The app already comes with the "Assistente" (Assistant) bot, which replies in Portuguese.

7

(Optional) Open a second team

An instance is a separate copy of the app, with its own bots, chats and memory. The name accepts letters, numbers, - and _.

kit/iniciar.sh --instancia trabalho   # data in ~/.local/share/time-de-bots/trabalho

On a VPS (running 24/7)

8

Download the kit to ~/time-de-bots

Log in to the server over SSH with a regular user that has sudo (not root). The service expects the kit in exactly this folder.

git clone https://github.com/inematds/time-de-bots.git ~/time-de-bots && cd ~/time-de-bots
9

Prepare the server

Installs the virtual screen, VNC and noVNC (programs that show that screen in your browser) and the app libraries (with sudo), installs Node 22 if missing, keeps the services running after you leave SSH and runs kit/instalar.sh. It doesn't open any port in the firewall. On the VPS, the sandbox is also enabled separately, with the commands in Cautions.

kit/vps/instalar-vps.sh
10

Log in to your account over SSH

instalar-vps.sh does not install Claude Code or Codex: install on the server the one you'll use (Claude Code via the installation guide; Codex with sudo npm i -g @openai/codex). There's no browser on the server; for Codex, use the device-code login.

claude                       # Claude account
codex login --device-auth    # or Codex account
11

Start the first instance

Creates the time-de-bots@principal service, which starts on its own and restarts if it crashes (up to 2 GB of memory per instance). At the end, it prints the tunnel command.

kit/vps/nova-instancia.sh principal 1   # screen :21, VNC 5921, browser 6081
12

Open it in the browser, through the tunnel

The SSH tunnel brings a server port to your computer through the SSH connection, without opening anything to the internet. On your computer, copy the command that nova-instancia.sh printed (or replace usuario@servidor with your user and the VPS IP) and leave the terminal open. Then, in the browser, go to the address and click Connect.

ssh -N -L 6081:127.0.0.1:6081 usuario@servidor
# in the browser:
http://localhost:6081/vnc.html
13

(Optional) Second team on the VPS, or shut down

The number (1 to 50) sets the screen and the ports: with 2, the browser is on port 6082.

kit/vps/nova-instancia.sh trabalho 2                # tunnel and browser on port 6082
systemctl --user disable --now time-de-bots@principal   # shuts down an instance
Time de Bots app screen in light theme, opened on the VPS through the browser, with the Assistente bot
Real screenshot: the app opened on a VPS, in the browser over an SSH tunnel (light theme), with the initial "Assistente" (Assistant) bot.
Ready-made prompts

Ask the assistant to do it for you

Paste them into Claude Code or Codex. The same texts are in kit/prompts/ (in Portuguese). The login is still yours: the assistant stops and waits for you to log in.

1 ยท Install and check on this computer

Installs, runs the tests, checks the real reply and opens a throwaway instance.

I want to install and check Time de Bots on this computer. The kit is in the current folder (if it isn't, clone https://github.com/inematds/time-de-bots.git into a new folder). Read README.md, kit/instalar.sh and kit/iniciar.sh before acting. Find out my system and architecture (uname -sm). Check Node.js 22+ and npm; if missing, tell me how to install them and wait. Run kit/instalar.sh and show me how many tests passed. Don't use an API key: I want to use my Claude or Codex subscription. Ask me which one. I do the login myself in the terminal (claude or codex login) โ€” don't ask for a token, don't open credential files. After my login, run node kit/scripts/conferir-resposta.mjs and show me whether the reply was real. Open the app with kit/iniciar.sh --instancia teste (a throwaway instance) and tell me where its data lives. At the end, deliver: system, Node version, tests that passed, whether the real reply came, command to open it and what was NOT tested. Don't say something works without testing it.

2 ยท Install on the VPS

Run it on the server, already connected over SSH. Prepares everything, starts the instance and checks that the ports are closed.

I want Time de Bots on an Ubuntu 24.04 or newer VPS, running 24/7 and reachable only through an SSH tunnel. I'm already logged in to the server over SSH with a regular user that has sudo (not root). Clone https://github.com/inematds/time-de-bots.git into ~/time-de-bots (the service expects that path). Read README.md and all the files in kit/vps/ before acting. Run kit/vps/instalar-vps.sh and show me the result. Don't open any port in the firewall and don't change anything to 0.0.0.0: VNC and the browser must stay on 127.0.0.1. Stop and ask me to log in to the account (claude, or codex login --device-auth). I do it; don't ask for a token. Then start the first instance with kit/vps/nova-instancia.sh principal 1 and show me the tunnel command it prints. Check with ss -ltn that the ports are only on 127.0.0.1 and with systemctl --user is-active that the service is active. At the end, deliver: tunnel command, address to open in the browser, how to start a second team (nova-instancia.sh trabalho 2), how to shut it down (systemctl --user disable --now time-de-bots@principal) and what was not tested.

3 ยท Build my first team

With the app already open: the assistant asks about your work and proposes 3 ready-to-copy bots.

Help me build my first team of bots in Time de Bots (the app is already open and connected to my subscription). First ask me: what my job is and which 3 repetitive tasks I'd most like to take off my plate. With the answers, propose 3 bots. For each one: name, role in one sentence, instructions (up to 8 lines, in English, saying what it does, what it doesn't do and the reply format) and, if it makes sense, a scheduled task (e.g.: weekdays at 8 a.m., "summary of what I need to do today"). Give them to me in blocks ready for me to copy into the app (+ button to create a bot; instructions can be edited later). Also tell me how to call all three together in a group chat (@name or @everyone). Don't make up integrations I don't have. Scheduled tasks only run with the app open (or on the VPS).
What was tested

Tested on November 9, 2026

Only what actually ran. Anything not listed here was not checked.

TestResult
App tests (npm test) on Linux ARM64193 of 193
App tests on an Ubuntu 24.04 x86_64 VPS (4 vCPU, 15 GB)193 of 193
Real reply through the Claude subscription (haiku model)received in 3.8 s, claude.ai login
Two instances at the same time on the computeropen, separate data
Two instances as a service on the VPSactive, ports only on 127.0.0.1
Real reply on the VPS, Codex, voice, cloud browser, Composionot tested

The tests above were run on Linux. The kit supports the Mac, but the Mac has not been tested yet.

Composio is an optional service that connects the bots to your other apps (email, calendar, spreadsheets), each one authorized by you, with a Composio account and key. Cloud browser is a separate computer, hosted by you, where the bot browses the web while you watch and can take over. Both come turned off.

Cautions

Before using it day to day

Experimental software, no warranty. Test first with a throwaway instance.

๐Ÿ”‘ Subscription only

The app only accepts the Claude Code claude.ai login or the Codex login. kit/iniciar.sh removes ANTHROPIC_API_KEY, OPENAI_API_KEY and CODEX_API_KEY from the environment, so nothing gets billed through the API without you noticing.

๐Ÿ“ Limits still apply

The subscription has usage limits and the provider's terms. The dashboard doesn't raise them: several bots share the same quota.

๐Ÿ™‹ The login is yours

Never paste a token or password into the assistant's chat. You do the login yourself, in the terminal.

๐Ÿ”’ Closed VPS

VNC and the browser listen only on 127.0.0.1. You get in through an SSH tunnel; nothing is left open to the internet.

๐Ÿงฑ Sandbox on Linux

The Electron sandbox is a protection that separates the app's screens from the rest of the system; without it the app opens the same, just with less protection. To enable it (once, after each npm ci), with sudo:

cd app/node_modules/electron/dist
sudo chown root:root chrome-sandbox
sudo chmod 4755 chrome-sandbox

๐Ÿ’พ Backup

Before updating, copy the data folder ~/.local/share/time-de-bots/. That's where each team's bots, chats and memory live.

FAQ

Quick questions

The essentials in a few lines.

Do I need an API key or to pay per use?

No. The app replies through your Claude or Codex subscription, with the login of the official program. API keys are removed from the environment before opening.

Do scheduled tasks run with the computer off?

No. They only run with the app open. To keep them running 24/7, use VPS mode.

Can I have more than one team?

Yes. Each --instancia (on the computer) or each nova-instancia.sh (on the VPS) is a separate team, with its own data.

How do I call several bots in one chat?

In a group chat, call them by name with @name, or all of them with @everyone.

Does Codex work?

Codex is one of the options in Settings โ†’ AI subscription, but the real reply through Codex hasn't been tested yet (see the table). The kit's reply test only checks Claude.

Why does "Electron sandbox disabled" show up?

On Linux, the sandbox needs a tweak with sudo. Without it the app opens the same way, with less isolation. The commands are in Cautions.

My server uses another SSH port or its own key. How do I open the tunnel?

Add the port and the key to the same command: ssh -i ~/.ssh/minha-chave -p 2222 -N -L 6081:127.0.0.1:6081 usuario@servidor. For the second team, another port: -L 6082:127.0.0.1:6082. If port 6081 is already in use on your computer, change only the first number (e.g. -L 7081:127.0.0.1:6081) and open http://localhost:7081/vnc.html.

conferir-resposta.mjs says "Login do Claude: NรƒO". What now?

Run claude as the same user that opens the app and sign in with your Claude account (not an API key). Check with claude auth status: it must show you signed in through claude.ai. If Claude Code is not installed, install it from the official site. On the VPS, after signing in, restart the team: systemctl --user restart time-de-bots@principal.