apache / apache/maka

TUI:macOS 无法启动

Open
#3,740 1 comment 0 reactions 0 assignees View on GitHub
bug help wanted
Dominant language
TypeScript
Stars
5.4k
Forks
502
Avg merge
1d 2h
Merged PRs (30d)
716

Description

### What happened

根据 https://github.com/apache/maka/blob/main/packages/cli/README.zh-CN.md
的说明, 安装后无法启动

### How to reproduce

1:
𝄢 npm install --global maka-agent@next
2:
λ maka --version
0.1.0-beta.1
3:
λ node --version
v26.4.0
4:
λ npm --verion
npm

Usage:

npm install install all the dependencies in your project
npm install add the dependency to your project
npm test run this project's tests
npm run run the script named
npm -h quick help on
npm -l display usage info for all commands
npm help search for help on
npm help npm more involved overview

All commands:

access, adduser, approve-scripts, audit, bugs, cache, ci,
completion, config, dedupe, deny-scripts, deprecate, diff,
dist-tag, docs, doctor, edit, exec, explain, explore,
find-dupes, fund, get, help, help-search, init, install,
install-ci-test, install-test, link, ll, login, logout, ls,
org, outdated, owner, pack, ping, pkg, prefix, profile,
prune, publish, query, rebuild, repo, restart, root, run,
sbom, search, set, shrinkwrap, stage, star, stars, start,
stop, team, test, token, trust, undeprecate, uninstall,
unpublish, unstar, update, version, view, whoami

Specify configs in the ini-formatted file:
/Users/zoomq/.npmrc
or on the command line via: npm --key=value

More configuration info: npm help config
Configuration fields: npm help 7 config

npm@11.17.0 /opt/homebrew/lib/node_modules/npm

### Environment

```

λ fastfetch
..' zoomq@ZQ160626rMBP
,xNMM. ------------------
.OMMMMo OS: macOS Tahoe 26.5.2 () arm64
lMM" Host: MacBook Pro (14-inch, 2021)
.;loddo:. .olloddol;. Kernel: Darwin 25.5.0
cKMMMMMMMMMMNWMMMMMMMMMM0: Uptime: 5 days, 14 hours, 58 mins
.KMMMMMMMMMMMMMMMMMMMMMMMWd. Packages: 520 (brew), 29 (brew-cask)
XMMMMMMMMMMMMMMMMMMMMMMMX. Shell: bash 3.2.57
;MMMMMMMMMMMMMMMMMMMMMMMM: Display (Color LCD): 2048x1280 in 14", 120 Hz [Built-in] *
:MMMMMMMMMMMMMMMMMMMMMMMM: Display (DELL P2721Q): 3360x1890 in 27", 60 Hz [External]
.MMMMMMMMMMMMMMMMMMMMMMMMX. Display (3): 1440x2560 in 17", 144 Hz [External]
kMMMMMMMMMMMMMMMMMMMMMMMMWd. WM: Quartz Compositor 341.4.4
'XMMMMMMMMMMMMMMMMMMMMMMMMMMk WM Theme: Blue (Light)
'XMMMMMMMMMMMMMMMMMMMMMMMMK. Theme: Liquid Glass
kMMMMMMMMMMMMMMMMMMMMMMd Font: .AppleSystemUIFont [System], Helvetica [User]
;KMMMMMMMWXXWMMMMMMMk. Cursor: Fill - Black, Outline - White (82px)
"cooc*" "*coo'" Terminal: ghostty 1.3.1
Terminal Font: OpenDyslexicMono (22pt)
CPU: Apple M1 Max (10) @ 3.23 GHz
GPU: Apple M1 Max (24) @ 1.30 GHz [Integrated]
Memory: 53.97 GiB / 64.00 GiB (84%)
Swap: 33.08 GiB / 34.00 GiB (97%)
Battery (bq40z651): 80% [AC connected]
Power Adapter: 65W
```

### Logs, screenshots, or additional context

𝄢 maka
RuntimeHostStartupError: Maka could not safely upgrade this workspace and left it unchanged. Reopen it with the previous Maka release to export or remove incompatible data, then try again. Diagnostic code: OPERATIONAL_STATE_MIGRATION_BLOCKED.
at runtimeHostStartupError (file:///opt/homebrew/lib/node_modules/maka-agent/node_modules/@maka/runtime-host/dist/client/startup-error.js:15:20)
at connect (file:///opt/homebrew/lib/node_modules/maka-agent/dist/runtime-host-cli-context.js:60:19)
at async connectRuntimeHostCli (file:///opt/homebrew/lib/node_modules/maka-agent/dist/runtime-host-cli-context.js:64:31)
at async createRuntimeHostTuiContext (file:///opt/homebrew/lib/node_modules/maka-agent/dist/runtime-host-tui-context.js:9:23)
at async createTuiContextWithHostConflictPrompt (file:///opt/homebrew/lib/node_modules/maka-agent/dist/runtime-host-tui-command.js:85:20)
at async runRuntimeHostTui (file:///opt/homebrew/lib/node_modules/maka-agent/dist/runtime-host-tui-command.js:23:19)

Contributor guide

Open the contributing guide

Research direction

Reproduce the macOS installation and run `maka` to confirm OPERATIONAL_STATE_MIGRATION_BLOCKED. Start with the stack-trace entry points `dist/runtime-host-tui-command.js`, `dist/runtime-host-tui-context.js`, `dist/runtime-host-cli-context.js`, and `dist/client/startup-error.js`; done means the TUI starts successfully without this startup error.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos, node.js, typescript
Domain
cli, desktop, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.