No description
  • Go 87.9%
  • Makefile 9.7%
  • Dockerfile 2.4%
Find a file
zemdregon c6b11541b2
Some checks are pending
CI / lint (push) Waiting to run
CI / test (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
chore(deps): bump actions/setup-go to v7 (#13)
* chore(deps): bump actions/setup-go to v7

Self-hosted CI workflows.

* ci: setup-go v7 + cache false
2026-08-12 09:47:28 -05:00
.github chore(deps): bump actions/setup-go to v7 (#13) 2026-08-12 09:47:28 -05:00
cmd/module Initial cache-local module. 2026-07-23 11:19:28 -05:00
deploy Initial cache-local module. 2026-07-23 11:19:28 -05:00
internal Add SettingsProvider for default TTL (v0.1.1). 2026-08-10 04:00:36 -05:00
test Initial cache-local module. 2026-07-23 11:19:28 -05:00
.dockerignore Initial cache-local module. 2026-07-23 11:19:28 -05:00
.env.example Add SettingsProvider for default TTL (v0.1.1). 2026-08-10 04:00:36 -05:00
.gitignore Initial cache-local module. 2026-07-23 11:19:28 -05:00
.golangci.yml docs: clarify cache.local vs legacy cache.memory alias (#10) 2026-08-09 20:06:59 -05:00
CHANGELOG.md Add SettingsProvider for default TTL (v0.1.1). 2026-08-10 04:00:36 -05:00
COMPATIBILITY.md docs: clarify cache.local vs legacy cache.memory alias (#10) 2026-08-09 20:06:59 -05:00
CONTRIBUTING.md Initial cache-local module. 2026-07-23 11:19:28 -05:00
Dockerfile Initial cache-local module. 2026-07-23 11:19:28 -05:00
go.mod Add SettingsProvider for default TTL (v0.1.1). 2026-08-10 04:00:36 -05:00
go.sum Add SettingsProvider for default TTL (v0.1.1). 2026-08-10 04:00:36 -05:00
LICENSE Initial cache-local module. 2026-07-23 11:19:28 -05:00
Makefile Initial cache-local module. 2026-07-23 11:19:28 -05:00
muxcore.json Add SettingsProvider for default TTL (v0.1.1). 2026-08-10 04:00:36 -05:00
README.md docs: clarify cache.local vs legacy cache.memory alias (#10) 2026-08-09 20:06:59 -05:00
SECURITY.md Initial cache-local module. 2026-07-23 11:19:28 -05:00

Cache Local

CI Go Version License: GPL-3.0

In-memory local read-through cache for the MuxCore storage orchestrator.

A MuxCore sidecar module that implements the cache.local capability via CacheLayerService (Get / Set / Invalidate). Entries expire after a default TTL; a background sweeper reclaims expired keys.


How It Works

storage orchestrator ──→ DialCacheLayer ──→ cache-local (gRPC) ──→ in-memory map

No external store. Data is process-local and lost on restart.


Configuration

Variable Default Description
CACHE_LOCAL_GRPC_ADDR :9610 gRPC listen address
MUXCORE_GRPC_ADDR Core mesh address (or --muxcore-mesh-addr)
MUXCORE_MODULE_ID cache-local Module ID override (or --muxcore-module-id)

Quick Start

make build
./cache-local --muxcore-mesh-addr localhost:9090

Core must be reachable (dev: MUXCORE_INSECURE_DISABLE_TLS=true ./muxcored in ../core).


Capability

Capability Role
cache.local Canonical — process-local in-memory CacheLayerService
cache.memory Legacy alias for the retired cache-memory dump; same implementation

See COMPATIBILITY.md. Prefer cache-redis for multi-host shared cache.

License

GPL-3.0