Skip to main content
Glama
EverOS Codex
by gix9303

EverOS Codex

简体中文

Use a local EverOS instance as long-term memory for Codex through MCP.

everos-codex provides:

  • an MCP bridge for local EverOS

  • repo-scoped default project_id inference

  • memory_search, memory_get, memory_save_turn, memory_flush

  • a bundled Codex skill: everos-local-memory

Why

This project keeps EverOS in its native local shape:

  • EverOS stays a local HTTP service, usually http://127.0.0.1:8000

  • Codex connects through MCP over stdio

  • memory stays local-first

Related MCP server: Codex Memory MCP Server

Install

Verify EverOS is running:

curl http://127.0.0.1:8000/health

Install the bundled Codex skill:

npx -y everos-codex install-skill

Add this MCP config to ~/.codex/config.toml:

[mcp_servers.everos]
command = "npx"
args = ["-y", "everos-codex"]

[mcp_servers.everos.env]
EVEROS_BASE_URL = "http://127.0.0.1:8000"
EVEROS_APP_ID = "codex"
EVEROS_DEFAULT_PROJECT_ID = ""
EVEROS_AGENT_ID = "codex"
EVEROS_AGENT_NAME = "Codex"
EVEROS_USER_ID = "your-user-id"
EVEROS_USER_NAME = "Your Name"
EVEROS_TIMEOUT_MS = "60000"

Restart Codex or open a fresh thread.

Quick checks

npx -y everos-codex doctor
npx -y everos-codex smoke

CLI

everos-codex start
everos-codex doctor
everos-codex smoke
everos-codex smoke-e2e
everos-codex install-skill

How project IDs work

If project_id is omitted and EVEROS_DEFAULT_PROJECT_ID is empty, everos-codex infers it from the current repo root name.

Examples:

  • water -> project_id=water

  • store-ops-suite -> project_id=store-ops-suite

  • EverOS-Codex -> project_id=everos-codex

Explicit project_id still wins.

Bundled skill

This repo bundles skills/everos-local-memory.

Its job is simple:

  • search before repeating work

  • save only high-value summaries

  • verify new memory with memory_get

  • avoid dumping whole conversations into memory

Acknowledgement

This project is built on top of the open-source EverMind-AI/EverOS project.

Thanks to the EverOS maintainers and contributors for making a local-first memory system available to the community.

License

Apache-2.0

Available Tools

4 tools
memory_flushC

Manually flush one EverOS session to force extraction.

Inputs: session_id (required), project_id.

memory_getA

List local EverOS memory deterministically. Best for read-your-write checks, recent memory browsing, or session_id-based verification.

Inputs: page, page_size, owner_type, project_id, +3 more.

memory_save_turnA

Save a high-value task summary into local EverOS. Use only for distilled outcomes, not whole chats.

Inputs: summary (required), flush, title, keywords, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

    TDQS

    A3.5/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct memory operation: flush clears session state, get lists memory entries, save_turn stores summaries, and search retrieves past context. No functional overlap.

    Naming Consistency4/5

    All tools follow the 'memory_<verb>' pattern, but 'save_turn' includes an object noun, making it slightly less consistent than the single-word verbs. Still, the pattern is clear and predictable.

    Tool Count5/5

    4 tools is ideal for a focused memory management server. Each tool serves a core function without redundancy or clutter.

    Completeness4/5

    The set covers memory flushing, retrieval, saving, and searching. Missing an explicit delete operation, but flush may serve that purpose. Minor gap, but core workflows are supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Local stdio MCP server for long-term engineering memory, enabling Codex to store, search, and manage project facts, progress, interfaces, and troubleshooting cases.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Codex to automatically recall and persist local project memory—such as decisions, constraints, goals, open loops, and milestones—across sessions via a secure, local MCP adapter.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides a shared local memory MCP server so multiple coding agents can store, retrieve, and attribute memories across sessions. It enables agents to recall project knowledge and past fixes with provenance.
      5
      Apache 2.0