You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 99844b6
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+65-28Lines changed: 65 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@
5
5
<h1align="center">Botloft</h1>
6
6
7
7
<palign="center">
8
-
<b>A crew of AI coding bots that stays on and works together on your computer, on the agent you prefer.</b>
8
+
<b>A crew of AI coding bots that stays on and works together on your computer.</b>
9
9
</p>
10
10
11
11
<palign="center">
@@ -34,34 +34,60 @@
34
34
35
35
Botloft keeps a crew of bots running on your computer, each on the AI coding agent you choose:
36
36
[Claude Code](https://code.claude.com), or, as experimental options,
37
-
[Antigravity](https://antigravity.google) and [Codex](https://developers.openai.com/codex). Each bot has its own folder, memory and conversation. They pass work to each other, keep going after you close the
38
-
window and pick up where they left off after a restart. You talk to each one like in a chat app, and
39
-
you decide what they may do.
37
+
[Antigravity](https://antigravity.google) and [Codex](https://developers.openai.com/codex). Each bot
38
+
has its own folder, memory and conversation. They pass work to each other, keep going after you
39
+
close the window and pick up where they left off after a restart. You talk to each one like in a
40
+
chat app, and you decide what they may do.
41
+
42
+
The latest release, 0.14.0, runs bots on Claude Code. Antigravity and Codex are on `main` and in no
43
+
release yet (see [Agents](#agents)).
40
44
41
45
## What you can do
42
46
43
47
-**Start a crew from a goal.** Say what the crew is for. Its Chief plans the work and suggests the
44
48
bots it needs; you create each one with a click, or say why not.
49
+
-**Pick ready-made bots.** The Bot agency has dozens of bots ready for a job, like a developer, a
50
+
designer, a writer, a researcher or customer support. Add one to a crew with a click and change
51
+
anything about it afterwards. The Chief uses the same list when it suggests a bot.
45
52
-**Chat with every bot.** Replies stream in as they are written. Send images and files. When a bot
46
53
wants to run a command, edit a file or open a website, a card asks you first, unless you told that
47
-
bot it may.
54
+
bot it may. Search every chat with Ctrl+K.
55
+
-**Answer their questions.** A bot that needs your decision asks in its chat and in the Questions
56
+
box, and goes on with what it can, even in a routine at night. Your answer reaches it as a message
57
+
whenever you reply.
48
58
-**Let them hand work to each other.** Bots send messages and tasks to each other. Every message is
49
59
saved before it is sent and retried until it arrives.
50
60
-**Watch them work.** See every page a bot opens in its browser, live, and take control to sign in
51
61
for it. Sites that refuse to sign in there, like Google, take one click more: sign in in a real
52
62
window of the bot's browser, close it, and the bot keeps the login. Watch the screens it designs
53
63
take shape while it writes them. Open the files it made.
64
+
-**Let them use your desktop apps (Windows).** A bot can read and use the apps open on your
65
+
computer, like a spreadsheet or an old program with no website, but only those you allow. It asks
66
+
in the chat, and seeing an app and using it are separate permissions. You watch it live, and
67
+
Ctrl+Alt+Esc stops every bot on your desktop. Giving a bot the whole desktop, or letting it work
68
+
while you are away, first shows a screen that spells out the risks. Botloft itself, terminals,
69
+
password managers and password fields are never shared.
54
70
-**Schedule routines.** Weekday mornings, every two hours or any cron schedule, with missed runs
55
71
and overlaps handled.
56
72
-**Leave them running.** Bots keep working after you close Botloft. They start when you sign in,
57
73
come back soon after a crash and keep the computer awake while they work. Botloft
58
74
waits near the clock and tells you when a bot needs you.
59
-
-**Choose per bot.** Which agent it runs on, which model it uses, and how much it asks before
60
-
acting. With Claude Code, see how much of your plan's usage is left.
75
+
-**Choose per bot.** Which model it uses and how much it asks before acting. See how much of your
76
+
plan's usage is left.
77
+
-**Connect your own tools.** Add a tool of yours in Settings > Connected tools, like a LinkedIn
78
+
reader or your company's system, and turn it on only for the bots that need it. They still ask you
79
+
before using it.
61
80
-**Back up and move.** Save a sealed backup file, or sign in with your e-mail (no password) to keep
62
81
a light copy in the cloud and restore it on another computer. The server cannot read it. Turn on
63
82
automatic copies, every day or week and only when something changed, if you want them to go by
64
83
themselves (Windows for now).
84
+
-**Keep up from your phone.** Choose "Connect a phone" in Settings > Account and phone and scan the
85
+
code with your phone's camera: Botloft opens there as a web page you can add to the Home Screen.
86
+
Approve requests, answer questions and chat with your bots from anywhere, with a notice when one
87
+
needs you. What passes between the phone and your computer is sealed end to end: the server
88
+
carries it but cannot read it. Anyone holding the phone unlocked can do the same, so you can lock
89
+
the page with a PIN. It uses the same account; files stay on your computer. Checked on Android,
90
+
not yet on iPhone.
65
91
66
92
<table>
67
93
<tr>
@@ -79,6 +105,9 @@ itself.
79
105
80
106
## Agents
81
107
108
+
Antigravity and Codex are only on `main` for now: no release has them yet. In a build of `main`,
109
+
Claude Code and Antigravity compare like this:
110
+
82
111
|| Claude Code | Antigravity (experimental) |
83
112
|---|---|---|
84
113
| Chat, crew messages, tasks, routines, the live browser | yes | chat, crew messages and tasks; the rest is not checked yet |
@@ -97,9 +126,9 @@ checked.
97
126
98
127
## Get started
99
128
100
-
You need at least one agent installed and signed in once, with your own account:
101
-
[Claude Code](https://code.claude.com/docs/en/setup), Antigravity or Codex
102
-
(experimental, see [Agents](#agents)). Bots run on your own plan with that agent.
129
+
You need [Claude Code](https://code.claude.com/docs/en/setup), installed and signed in once with
130
+
your own account. Bots run on your own plan. (Antigravity and Codex, the experimental agents, are
Copy file name to clipboardExpand all lines: docs/code-signing-policy.md
+11-1Lines changed: 11 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -57,12 +57,22 @@ listens on `127.0.0.1` only. What goes over the network:
57
57
information about you or your bots is sent.
58
58
-**Your bots.** Each bot is Claude Code running on your computer with your own Claude account. What
59
59
it sends to Anthropic, and the websites it opens when its work needs them, are the same as when
60
-
you use Claude Code yourself.
60
+
you use Claude Code yourself. So is what it sends to a tool you connect and turn on for it
61
+
(Settings > Connected tools); a tool at an address is outside your computer.
61
62
-**The optional cloud account.** Only if you sign in, and only when you send a copy or turn on automatic copies (every day or week, and only when something changed). The server gets your
62
63
e-mail address, the name of your computer, and the light backup you choose to upload: it is sealed
63
64
on your computer with the backup password, which never leaves it, so the server cannot read it. For automatic copies Windows keeps that password in its credential store, readable only by your user account.
64
65
Signing out, deleting a copy or deleting the account is in the app. The server is the
65
66
`botloft-cloud` crate in this repository, and the address is a setting, so you can run your own.
67
+
-**A connected phone.** Only if you connect one (Settings > Account and phone), which needs the
68
+
account. While a phone is connected, or you are connecting one, the background service keeps one
69
+
outgoing connection to the server, which carries what the phone and the computer say to each
70
+
other: requests, questions, answers and the bots' chats. It is sealed end to end with keys only
71
+
the two of them have, so the server sees when and how much passes, never what. The server keeps
72
+
the phone's name and, if you turn on notices on the phone, the address its browser gave for them.
73
+
Each notice is empty and goes through that browser's push service, which learns only that a
74
+
notice arrived. Disconnecting the phone, from the computer or from the phone itself, cuts it off
75
+
at once, and signing out of the account disconnects every phone.
Copy file name to clipboardExpand all lines: docs/spec.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2353,7 +2353,7 @@ Testes: `crates/botloft-store` (a impressão digital muda com o que o dono faz e
2353
2353
2354
2354
## 28. Celular
2355
2355
2356
-
Status: **CE1 (spec).** Vem depois de 27 e usa a conta dela. É o "celular" que 27.9 deixou para depois.
2356
+
Status: **CE1 a CE6 implementados**, no 0.14.0. Do CE7 (teste real), o que já se viu e o que falta está em "A verificar" (28.10). Vem depois de 27 e usa a conta dela. É o "celular" que 27.9 deixou para depois.
2357
2357
2358
2358
### 28.1 O que é
2359
2359
@@ -2520,7 +2520,7 @@ Arquivos e anexos, tarefas e rotinas no celular (conversa, só de texto, está e
2520
2520
2521
2521
### 28.12 Conversas
2522
2522
2523
-
Status: **CH3 (PWA feito)**. O celular, que só aprovava e respondia (28.1), passa a **ler as conversas dos bots e a mandar texto a eles**. O que ele continua sem fazer: anexos e arquivos (ver, mandar ou abrir), telas e navegador do bot, tarefas, rotinas, reações, busca, e qualquer configuração.
2523
+
Status: **CH1 a CH3 feitos**, no 0.14.0; o CH4 foi visto no Android e falta o iPhone. O celular, que só aprovava e respondia (28.1), passa a **ler as conversas dos bots e a mandar texto a eles**. O que ele continua sem fazer: anexos e arquivos (ver, mandar ou abrir), telas e navegador do bot, tarefas, rotinas, reações, busca, e qualquer configuração.
2524
2524
2525
2525
**O que muda na privacidade (28.9).** Até aqui só passavam pedidos e perguntas. Agora passa **o texto das conversas**, e continua selado de ponta a ponta: o servidor não o lê. Ele vê um pouco mais do ritmo (mais mensagens, de tamanhos variados, quando alguém conversa), mas nada do que se diz. E um celular desbloqueado e conectado passa a **ler o histórico dos bots e a falar com eles**: por isso o aviso do app (28.7) diz isso também, e a regra abaixo protege o que há de pior.
2526
2526
@@ -2563,7 +2563,7 @@ Status: **CH3 (PWA feito)**. O celular, que só aprovava e respondia (28.1), pas
2563
2563
2564
2564
### 28.13 Trava com PIN
2565
2565
2566
-
Status: **LK1 (spec)**. Um celular desbloqueado e conectado aprova pedidos (28.5) e, com as conversas (28.12), lê e fala com os bots: quem o segurar faz o que o dono faria. A trava é um **PIN do próprio app**, que o dono **liga se quiser**. O app **não obriga**: explica o motivo e deixa a decisão com o dono.
2566
+
Status: **LK1 e LK2 feitos**, no 0.14.0 (o que já foi visto e o que falta, no fim desta seção). Um celular desbloqueado e conectado aprova pedidos (28.5) e, com as conversas (28.12), lê e fala com os bots: quem o segurar faz o que o dono faria. A trava é um **PIN do próprio app**, que o dono **liga se quiser**. O app **não obriga**: explica o motivo e deixa a decisão com o dono.
2567
2567
2568
2568
**O que o app diz, em palavras do dia a dia.** Na tela do celular (28.7): "Com um PIN, quem pegar este celular desbloqueado não consegue ler suas conversas nem aprovar pedidos. Sem ele, o celular fica aberto para quem o segurar." Depois de conectar, e enquanto não houver PIN, a caixa mostra um aviso curto com o mesmo motivo, **"Proteger com um PIN"** e **"Agora não"** (o "agora não" é lembrado no aparelho e o aviso não volta; o PIN segue em "Este celular").
0 commit comments