firekeep-client
The portable client kit for Firekeep — a self-hosted
control plane for AI coding agents: persistent team memory, session
continuity, environment awareness, agent coordination, and replayable decision
traces. Every capability is an MCP tool behind one local firekeep gateway;
shipped adapters configure Claude Code, Codex, Kiro, and OpenCode, and any
MCP-capable client can connect.
mcp-name: io.github.kapella-hub/firekeep
What this package is
The client half of Firekeep: the stdio MCP gateway (firekeep gateway) that
aggregates your team server's services (memory, sessions, environment,
coordination) plus client-local code intelligence and the Decision Board, the
lifecycle hook cores, the runtime adapters, and the firekeep CLI
(install, join, doctor, update).
Firekeep is self-hosted — this package needs a server to talk to. Each team runs its own server on any Docker host, with per-key authentication. There is no hosted endpoint. Server install: firekeep.ai/docs.html.
Install
The recommended path is the managed installer, which pins a private
environment under ~/.firekeep, verifies Ed25519-signed releases, renders
every runtime adapter, and keeps itself updated:
curl -fsSL https://firekeep.ai/latest/install.sh | sh # macOS / Linux
irm https://firekeep.ai/latest/install.ps1 | iex # Windows
Installing from PyPI works too and gives you the same CLI and gateway:
pip install firekeep-client # gateway + CLI + hooks + adapters
pip install "firekeep-client[symdex]" # + client-local code intelligence
firekeep join fk_join_... # single-use code from your team's dashboard
firekeep install # render adapters for your agent clients
Note the trade-off: a pip install lives in whatever environment you put it in and updates when you update it; the managed installer owns its environment, verifies release signatures against a pinned key, and swaps versions without closing agent sessions.
Connect an MCP client manually
Any MCP client can launch the gateway over stdio once firekeep join has
written the connection:
{
"mcpServers": {
"firekeep": { "command": "firekeep", "args": ["gateway"] }
}
}
Links
- Product and docs: https://firekeep.ai · https://firekeep.ai/docs.html
- Why agents need this: https://firekeep.ai/agents-md-vs-memory.html
- The instruction-compliance study: https://firekeep.ai/instruction-compliance.html
- Security contact: security@firekeep.ai
License
BUSL-1.1 (source-available). Free for individual use — production use by one natural person in one workspace. Teams of more than one person run on a paid commercial subscription (sales@firekeep.ai). Each version converts to Apache-2.0 four years after its first public release.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file firekeep_client-0.1.43.tar.gz.
File metadata
- Download URL: firekeep_client-0.1.43.tar.gz
- Upload date:
- Size: 499.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e3353322680d52cbdfcbd378e95283b82a433d46d706a3e5a481547119be650
|
|
| MD5 |
2e3f167881774a9fdd6a807ee6edf02f
|
|
| BLAKE2b-256 |
751ac7da188a165e0a97f665da4c9fdebefb6b8a4f4e9c58e69082e2522666a6
|
Provenance
The following attestation bundles were made for firekeep_client-0.1.43.tar.gz:
Publisher:
release.yml on kapella-hub/FirekeepHQ
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
firekeep_client-0.1.43.tar.gz -
Subject digest:
2e3353322680d52cbdfcbd378e95283b82a433d46d706a3e5a481547119be650 - Sigstore transparency entry: 2455480346
- Sigstore integration time:
-
Permalink:
kapella-hub/FirekeepHQ@04ca825438f5d13287b624b3daa993ed8589290a -
Branch / Tag:
refs/tags/client-v0.1.43 - Owner: https://github.com/kapella-hub
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@04ca825438f5d13287b624b3daa993ed8589290a -
Trigger Event:
push
-
Statement type:
File details
Details for the file firekeep_client-0.1.43-py3-none-any.whl.
File metadata
- Download URL: firekeep_client-0.1.43-py3-none-any.whl
- Upload date:
- Size: 363.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
71f9e71adc36a5146ef6bf9b523e69bf9b324e8f3c4315df9daa8bfb0601751b
|
|
| MD5 |
ab2fd997d58e4cacf009afe7730ebf6e
|
|
| BLAKE2b-256 |
15279df6c04feacb4a97f816b71c42f2aac6edaf7d1a3f5a9a5538dcd0053d88
|
Provenance
The following attestation bundles were made for firekeep_client-0.1.43-py3-none-any.whl:
Publisher:
release.yml on kapella-hub/FirekeepHQ
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
firekeep_client-0.1.43-py3-none-any.whl -
Subject digest:
71f9e71adc36a5146ef6bf9b523e69bf9b324e8f3c4315df9daa8bfb0601751b - Sigstore transparency entry: 2455480611
- Sigstore integration time:
-
Permalink:
kapella-hub/FirekeepHQ@04ca825438f5d13287b624b3daa993ed8589290a -
Branch / Tag:
refs/tags/client-v0.1.43 - Owner: https://github.com/kapella-hub
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@04ca825438f5d13287b624b3daa993ed8589290a -
Trigger Event:
push
-
Statement type:
