larksuite / larksuite/cli

macOS arm64: v1.0.68 hangs on startup after update (even `--version`)

Open
#1,849 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

domain/auth
Dominant language
Go
Stars
17.3k
Forks
1.4k
Avg merge
2d 4h
Merged PRs (30d)
105

Description

Summary

On macOS Apple Silicon, updating lark-cli from v1.0.61 to v1.0.68 succeeds, but the CLI then hangs at startup. Even lark-cli --version produces no output and does not exit.

Environment

  • macOS 15.7.7 (24G720)
  • Apple Silicon / arm64
  • Node.js v26.3.0
  • Installed through npm (@larksuite/cli)
  • Working version before update: v1.0.61
  • Failing versions tested: v1.0.67 and v1.0.68

Steps to reproduce

lark-cli update --json
lark-cli --version

Actual behavior

The update command completes and npm shows the target package version installed, but lark-cli --version hangs indefinitely with no stdout or stderr. Other commands such as lark-cli auth status --json --verify behave the same way.

Restarting the Mac did not resolve it. Reinstalling v1.0.67 and v1.0.61 after the failed update also initially showed the same startup hang until stale processes were cleared; a clean v1.0.61 installation is the only version that has been reliably usable.

The launched native binary is .../node_modules/@larksuite/cli/bin/lark-cli (Mach-O arm64, code signature verifies successfully).

Expected behavior

After a successful update, lark-cli --version should print the version promptly and other commands should run normally.

Related issue

Possibly related to #165 (macOS arm64 binary startup failure), but this manifests as an indefinite hang rather than an immediate exit code 137.

I can provide more diagnostics if there is a preferred trace/log command.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the hang with lark-cli --version after updating to v1.0.67 or v1.0.68, then compare behavior with a clean v1.0.61 installation. Inspect the launched native binary at node_modules/@larksuite/cli/bin/lark-cli and use the preferred trace or log command to identify where startup blocks. Done means the updated arm64 CLI prints its version promptly and other commands start normally.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, macos
Domain
cli, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.