Skip to content

Add toolstile server to run Toolstile locally - #27

Merged
akshitkrnagpal merged 6 commits into
mainfrom
local-server
Nov 22, 2026
Merged

akshitkrnagpal merged 6 commits into
mainfrom
local-server

Conversation

@akshitkrnagpal

@akshitkrnagpal akshitkrnagpal commented Nov 22, 2026 •

Copy link
Copy Markdown
Contributor

npx toolstile server start|install|upgrade|uninstall downloads the open-source toolstile-server executable from the latest toolstile/toolstile release (macOS on Apple silicon, Linux x64 and arm64), checks its SHA-256 and runs it with its own embedded database.

  • start installs on first use and initializes a new instance. A new loopback instance prints its own one-time setup link; --email prints an invitation link instead, for instances other people reach over the network.
  • upgrade refuses while the server runs, backs up the instance, then installs the new executable and keeps the previous one.
  • uninstall removes the executable and keeps data and backups.
  • bootstrap, operator, backup, restore and version pass through to the server.

Checked: typecheck, 188 tests, and installing v0.1.0 through server install then server version.

🤖 Generated with Claude Code


Proof this PR
Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.

akshitkrnagpal and others added 6 commits November 22, 2026 11:14
`npx toolstile server start` downloads the toolstile-server executable for
this platform from the latest release, checks it against its published
SHA-256 checksum and installs it in ~/.local/share/toolstile-server. On a
new instance it runs init, asks for an email and prints the invitation
link, then runs the server in the foreground and passes Ctrl-C on once so
the server drains.

install, upgrade and uninstall manage the executable: upgrade refuses while
the instance runs, backs it up first and keeps the previous executable.
Other server commands run toolstile-server directly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A new loopback instance prints a one-time setup link when it starts, so
server start no longer asks for an email. --email still creates an
invitation, and other new instances are pointed at bootstrap.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
bootstrap needs the database the running server holds, so the hint now
asks to restart with --email (keeping --data-dir). The help text
describes the setup link, and the server context no longer carries stdin.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…n help

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@akshitkrnagpal
akshitkrnagpal merged commit 0a64555 into main Nov 22, 2026
2 checks passed
@akshitkrnagpal akshitkrnagpal mentioned this pull request Nov 22, 2026
@akshitkrnagpal
akshitkrnagpal deleted the local-server branch November 22, 2026 06:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant