Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,12 @@ the open-source home for EverMe CLI and agent plugins.

### CLI

- Add `evercli plugin install seekmoon`. SeekMoon (moonbitlang/openseek) reads
MCP servers from `mcpServers.<name>` in its runtime directory's
`host-mcp.json`, so the adapter reuses the shared MCP writer and preserves
the desktop's own `seekmoon` entry; uninstall removes only EverMe's. The
install reports a new-conversation next step: a desktop conversation's engine
connects its MCP servers once at startup.
- Sync the `cli/` Go tree to the `evercli` v0.32.0 release. Earlier public
snapshots trailed the published binaries; the tree now matches what
`npm install -g @everme/cli` and the release archives ship.
Expand Down
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,13 +87,14 @@ evercli plugin install kimicode
evercli plugin install opencode
evercli plugin install openclaw
evercli plugin install raven
evercli plugin install seekmoon
evercli plugin install workbuddy

# 4. Verify
evercli doctor
```

Kimi Code needs one final host-owned step after staging: run `/plugins install ~/.kimi-code/everme` inside its TUI. WorkBuddy asks you to trust the new MCP server in its MCP management dialog.
Kimi Code needs one final host-owned step after staging: run `/plugins install ~/.kimi-code/everme` inside its TUI. WorkBuddy asks you to trust the new MCP server in its MCP management dialog. SeekMoon connects its MCP servers when a conversation starts, so open a new conversation (or relaunch the app) to get `everme-memory`.

Once installed, open your Agent and ask "what do you remember about me?" — it will use the MCP `mem://profile` resource to recall.

Expand Down Expand Up @@ -137,6 +138,7 @@ Each Agent has its own configuration surface. `evercli plugin install <agent>` a
| **OpenCode** | `evercli plugin install opencode` | `~/.config/opencode/opencode.json` MCP entry |
| **OpenClaw** | `evercli plugin install openclaw` | OpenClaw plugin registration |
| **Raven** | `evercli plugin install raven` | `~/.raven/config.json` + embedded MemoryBackend |
| **SeekMoon** | `evercli plugin install seekmoon` | App runtime dir `host-mcp.json` MCP entry + new-conversation step |
| **WorkBuddy** | `evercli plugin install workbuddy` | `~/.workbuddy/mcp.json` + first-connection trust step |

The memory each Agent reads and writes lives in **one shared memory pool** keyed to your account — so context follows *you*, not the app.
Expand Down
4 changes: 3 additions & 1 deletion README.zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,13 +87,14 @@ evercli plugin install kimicode
evercli plugin install opencode
evercli plugin install openclaw
evercli plugin install raven
evercli plugin install seekmoon
evercli plugin install workbuddy

# 4. 自检
evercli doctor
```

Kimi Code 完成预配置后,还需要在 TUI 内运行 `/plugins install ~/.kimi-code/everme`;WorkBuddy 则需要在 MCP 管理界面信任新增的服务。
Kimi Code 完成预配置后,还需要在 TUI 内运行 `/plugins install ~/.kimi-code/everme`;WorkBuddy 则需要在 MCP 管理界面信任新增的服务。SeekMoon 在会话启动时连接 MCP 服务,因此请新开一个会话(或重启应用)来启用 `everme-memory`。

装好后打开你的 Agent,问它 "what do you remember about me?" —— 它会通过 MCP `mem://profile` 资源去召回你的记忆。

Expand Down Expand Up @@ -137,6 +138,7 @@ Kimi Code 完成预配置后,还需要在 TUI 内运行 `/plugins install ~/.k
| **OpenCode** | `evercli plugin install opencode` | `~/.config/opencode/opencode.json` MCP 条目 |
| **OpenClaw** | `evercli plugin install openclaw` | OpenClaw 插件注册 |
| **Raven** | `evercli plugin install raven` | `~/.raven/config.json` + 内置 MemoryBackend |
| **SeekMoon** | `evercli plugin install seekmoon` | 应用运行目录的 `host-mcp.json` MCP 条目 + 新会话步骤 |
| **WorkBuddy** | `evercli plugin install workbuddy` | `~/.workbuddy/mcp.json` + 首次连接信任步骤 |

所有 Agent 读写的记忆都落在**同一份记忆池**里,按你的账号隔离 —— 所以上下文跟着**你**走,而不是被锁在某个 App 里。
Expand Down
2 changes: 1 addition & 1 deletion cli/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ This file is self-contained and governs `cli/` only — it references no files o
Five subcommands, intentionally minimal:

- `auth` — login / logout / status / me
- `plugin` — list / install / uninstall (Claude Code, OpenClaw, Cursor, Claude Desktop, Codex, Hermes, Devin, WorkBuddy, opencode, Kimi Code, Raven)
- `plugin` — list / install / uninstall (Claude Code, OpenClaw, Cursor, Claude Desktop, Codex, Hermes, Devin, WorkBuddy, SeekMoon, opencode, Kimi Code, Raven)
- `import` — conversations scan / run (cold-start session + markdown import)
- `doctor` — slim self-checks (network reachability + credential backend)
- `skill` — browse / install / manage EverMe skills
Expand Down
2 changes: 1 addition & 1 deletion cli/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ evercli --version # build identity
| Command | Purpose |
|-----------|------------------------------------------------------|
| `auth` | login / logout / status / me |
| `plugin` | list / install / uninstall (Claude Code, OpenClaw, Cursor, Claude Desktop, Codex, DeepSeek Harness, Hermes, Devin, WorkBuddy, opencode, Kimi Code, Raven) |
| `plugin` | list / install / uninstall (Claude Code, OpenClaw, Cursor, Claude Desktop, Codex, DeepSeek Harness, Hermes, Devin, WorkBuddy, SeekMoon, opencode, Kimi Code, Raven) |
| `import` | conversations scan / run (cold-start session + markdown import) |
| `doctor` | minimal self-checks (connectivity + credential) |
| `skill` | browse / install / manage EverMe skills |
Expand Down
10 changes: 10 additions & 0 deletions cli/internal/plugin/registry.go
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,14 @@ type registry struct {
// a protected ~/.dsh/.env credential block because DSH scrubs inherited
// credential-shaped variables before spawning stdio MCP servers.
// Implements Preparer, Verifier and Remover. See dsh.go.
//
// - PlatformSeekMoon → seekMoonWriter
// SeekMoon reads MCP servers from `mcpServers.<name>` in its runtime
// directory's host-mcp.json, so it reuses mcpWriter. The desktop keeps
// its own `seekmoon` entry (a per-launch localhost tool server) in the
// same file; the shared upsert preserves it. Commit adds a restart
// NextStep because a conversation fixes its server list at engine
// session start. See seekmoon.go.
func DefaultRegistry() *registry {
return &registry{
detectors: map[Platform]Detector{
Expand All @@ -98,6 +106,7 @@ func DefaultRegistry() *registry {
PlatformKimiCode: kimiCodeDetector{},
PlatformRaven: ravenDetector{},
PlatformDSH: dshDetector{},
PlatformSeekMoon: seekMoonDetector{},
},
writers: map[Platform]Writer{
PlatformClaudeCode: newClaudeCodeWriter(),
Expand All @@ -112,6 +121,7 @@ func DefaultRegistry() *registry {
PlatformKimiCode: newKimiCodeWriter(),
PlatformRaven: newRavenWriter(),
PlatformDSH: newDSHWriter(),
PlatformSeekMoon: newSeekMoonWriter(),
},
}
}
Expand Down
3 changes: 2 additions & 1 deletion cli/internal/plugin/registry_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ import (
// make install hand back a nil writer/detector at runtime.
func TestDefaultRegistry_NewHostsRegistered(t *testing.T) {
r := DefaultRegistry()
for _, p := range []Platform{PlatformDSH, PlatformDevin, PlatformOpenCode, PlatformWorkBuddy} {
for _, p := range []Platform{PlatformDSH, PlatformDevin, PlatformOpenCode, PlatformWorkBuddy, PlatformSeekMoon} {
assert.True(t, r.Has(p), "detector missing for %s", p)
assert.NotNil(t, r.writer(p), "writer missing for %s", p)
assert.NotNil(t, r.detector(p), "detector nil for %s", p)
Expand All @@ -22,4 +22,5 @@ func TestDefaultRegistry_NewHostsRegistered(t *testing.T) {
assert.Contains(t, supported, PlatformDevin)
assert.Contains(t, supported, PlatformOpenCode)
assert.Contains(t, supported, PlatformWorkBuddy)
assert.Contains(t, supported, PlatformSeekMoon)
}
154 changes: 154 additions & 0 deletions cli/internal/plugin/seekmoon.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
// Package plugin — SeekMoon support.
//
// SeekMoon (moonbitlang/openseek) is a desktop agent whose engine reads MCP
// servers from a JSON file with the same top-level `mcpServers.<name>` shape as
// Claude Desktop, so the writer reuses `mcpWriter` verbatim. What differs is
// where that file lives: the desktop keeps it in its runtime directory, next to
// `engine-settings.json`.
//
// macOS ~/Library/Application Support/SeekMoon/host-mcp.json
// Windows %APPDATA%\SeekMoon\host-mcp.json
// Linux ~/.config/SeekMoon/host-mcp.json
//
// SeekMoon also writes its own `seekmoon` entry into that same file — the
// desktop's tool server, reachable at a per-launch localhost URL. The shared
// upsert in mcp.go only touches `mcpServers.<mcpEntryName>`, so the desktop's
// entry and any server the user added by hand survive the install unchanged.
//
// EVERCLI_SEEKMOON_CONFIG_DIR pins the runtime directory (tests), and
// EVERCLI_SEEKMOON_APP_PATH pins the macOS bundle path.
package plugin

import (
"context"
"os"
"os/exec"
"path/filepath"

"evercli/internal/output"
)

// seekMoonConfigFile is the only file SeekMoon reads user MCP servers from.
// `engine-settings.json` next to it holds model/provider settings; `skills/`
// and `schedules/` are the app's own state. Do not probe alternatives.
const seekMoonConfigFile = "host-mcp.json"

type seekMoonDetector struct{}

func (seekMoonDetector) Platform() Platform { return PlatformSeekMoon }

func (seekMoonDetector) DisplayName() string { return "SeekMoon" }

func (seekMoonDetector) Detect(_ context.Context) (*Detection, error) {
dir, err := seekMoonConfigDir()
if err != nil {
return &Detection{Platform: PlatformSeekMoon, DisplayName: "SeekMoon"}, nil
}
detection := &Detection{
Platform: PlatformSeekMoon,
DisplayName: "SeekMoon",
ConfigPath: seekMoonConfigPathInDir(dir),
Installed: seekMoonInstalled(dir),
}

config, exists, err := readConfig(detection.ConfigPath)
if err != nil {
return detection, err
}
detection.ConfigExists = exists
if exists {
detection.HasEverMeEntry = nestedMcpServersHasEntry(config, claudeCodeServersPath, mcpEntryName)
}
return detection, nil
}

func seekMoonConfigPath() (string, error) {
dir, err := seekMoonConfigDir()
if err != nil {
return "", err
}
return seekMoonConfigPathInDir(dir), nil
}

func seekMoonConfigPathInDir(dir string) string {
return filepath.Join(dir, seekMoonConfigFile)
}

// seekMoonConfigDir resolves SeekMoon's runtime directory. The desktop creates
// it on first launch; the layout mirrors the app's own resolution so an install
// lands where the engine actually reads.
func seekMoonConfigDir() (string, error) {
if dir := os.Getenv("EVERCLI_SEEKMOON_CONFIG_DIR"); dir != "" {
return dir, nil
}
home, err := os.UserHomeDir()
if err != nil {
return "", output.IOErr("seekmoon", "resolve-home", err)
}
switch runtimeGOOS() {
case "darwin":
return filepath.Join(home, "Library", "Application Support", "SeekMoon"), nil
case "windows":
// The desktop uses the Roaming profile for its runtime directory;
// os.UserConfigDir() already points there on Windows.
if appdata, err := os.UserConfigDir(); err == nil && appdata != "" {
return filepath.Join(appdata, "SeekMoon"), nil
}
return filepath.Join(home, "AppData", "Roaming", "SeekMoon"), nil
default:
return filepath.Join(home, ".config", "SeekMoon"), nil
}
}

// seekMoonInstalled reports whether SeekMoon is on this machine. A desktop app
// has no canonical CLI, so the runtime directory and the macOS bundle are the
// presence signals; `seekmoon` / `openseek` on PATH covers the CLI-only
// installs that ship next to the desktop build.
func seekMoonInstalled(configDir string) bool {
if _, err := os.Stat(configDir); err == nil {
return true
}
if appPath := os.Getenv("EVERCLI_SEEKMOON_APP_PATH"); appPath != "" {
if _, err := os.Stat(appPath); err == nil {
return true
}
// Stale override: fall through to the PATH / darwin probes
// instead of declaring SeekMoon absent outright.
}
for _, name := range []string{"seekmoon", "openseek"} {
if _, err := exec.LookPath(name); err == nil {
return true
}
}
if runtimeGOOS() == "darwin" {
for _, path := range []string{"/Applications/SeekMoon.app", filepath.Join(os.Getenv("HOME"), "Applications", "SeekMoon.app")} {
if _, err := os.Stat(path); err == nil {
return true
}
}
}
return false
}

// seekMoonWriter wraps the shared mcpWriter to say when the entry takes effect.
// SeekMoon connects its MCP servers once per engine process and reuses those
// connections across turns: a desktop conversation runs its own engine, spawned
// with `--mcp-config=<runtime>/host-mcp.json`, and connects at startup
// (internal/openseek/serve/loop.mbt). A config written now is therefore picked
// up by the next engine — a new conversation, or a relaunch of the app.
type seekMoonWriter struct {
*mcpWriter
}

func newSeekMoonWriter() Writer {
return seekMoonWriter{newMCPWriter(PlatformSeekMoon)}
}

func (w seekMoonWriter) Commit(ctx context.Context, plan *WritePlan, params WriteParams) (*WriteResult, error) {
res, err := w.mcpWriter.Commit(ctx, plan, params)
if res != nil {
res.NextSteps = append(res.NextSteps,
"start a new conversation in SeekMoon (or relaunch the app): a conversation's engine connects its MCP servers once at startup and keeps them for its lifetime, so this conversation will not see everme-memory")
}
return res, err
}
Loading