Repository navigation
Releases
Lark Agent Bridge v0.2.0-alpha.8
Lark Agent Bridge v0.2.0-alpha.8
Configurable agent identity, named resource memories and clearer task progress.
- Define the assistant's name, role, business context, working style, language and action boundaries during setup or in Settings. Preferences persist across /new and apply to the next work request. Permissions remain separate.
- Home's Recent Links captures Lark resource links from authorized chat messages and agent replies. Refresh from chat scans the latest 50 messages. Save a link with a name and description in the existing chat-scoped permanent memory store for future reference.
- Home now shows a compact connection section, Recent Links, task status and Recent Activity. Connection details are collapsed by default.
- Find the installed version in Settings ? About Lark Agent Bridge and at the bottom of the sidebar.
- Setup links open the official Codex CLI or Claude Code installation and sign-in guide.
- Follow live task stages, elapsed time and last progress. A quiet-progress warning does not mean the provider or tool has stopped. Delivered, failed, cancelled, timed-out and partial results are distinct.
- /new cancels active work and clears queued requests before resetting conversation and attachment context. Permanent memories, identity preferences and local files are retained.
Same-version update: the version remains 0.2.0-alpha.8. Quit the older app and download/install alpha.8 again to receive these additions. Settings, sign-ins, memories and local files are retained. Updates are manual.
Downloads
Windows x64: EXE installer. Linux x64: AppImage or Debian/Ubuntu package. Mac Apple Silicon ARM64: testing DMG or ZIP. Intel Mac builds are not included.
Windows testing builds are unsigned.
Important Mac testing information
The Mac build has an ad-hoc testing signature and is not Apple Developer ID signed or notarized. It does not pass Gatekeeper approval. Follow your organization's installation policies and Apple's guidance: https://support.apple.com/en-us/102445.
Verification and licences
The release workflow runs core regression tests, source desktop tests and packaged desktop/PDF tests on Windows, macOS and Linux. Mac validation checks DMG/ZIP signatures and tests the app copied out of the DMG. These checks use mock accounts and do not cover every live Lark organization or provider.
See LICENSE.txt, THIRD_PARTY_NOTICES.md and SHA256SUMS.txt in Assets. The bridge code is proprietary; third-party licences remain applicable. Automatically generated source archives contain only the public download repository.
Lark Agent Bridge v0.2.0-alpha.7
Lark Agent Bridge v0.2.0-alpha.7
Make the result of Lark authorization clear during initial setup.
- Show a verification state after approval, with no repeated QR or approval instructions.
- Advance verified setup authorization automatically to the work-folder step when the AI agent is ready.
- Display a visible authorization confirmation. Returning to the Lark step shows the authorized account and a separate Change feature selection action.
- Keep Settings authorization in Settings and confirm the account there.
- Keep verification failures visible and prevent cancelled verification from binding an account or advancing setup.
Account authorization is followed by a separate bot-message test. Feature selections control the next authorization request; they are not proof of every effective permission. Unchecking a feature does not revoke existing grants. Existing settings and memories are retained.
Quit the older app, install this update, and reopen setup. If you already approved Lark, use Check connection before authorizing again.
Downloads
Windows x64: EXE installer. Linux x64: AppImage or Debian/Ubuntu package. Mac Apple Silicon ARM64: testing DMG or ZIP. Intel Mac builds are not included.
Windows testing builds are unsigned.
Important Mac testing information
The Mac build has an ad-hoc testing signature and is not Apple Developer ID signed or notarized. It does not pass Gatekeeper approval. Follow your organization's installation policies and Apple's guidance: https://support.apple.com/en-us/102445.
Verification and licences
The release workflow runs core regression tests, source desktop tests and packaged desktop/PDF tests on Windows, macOS and Linux. Mac validation checks DMG/ZIP signatures and tests the app copied out of the DMG. These checks use mock accounts and do not cover every live Lark organization or provider.
See LICENSE.txt, THIRD_PARTY_NOTICES.md and SHA256SUMS.txt in Assets. The bridge code is proprietary; third-party licences remain applicable. Automatically generated source archives contain only the public download repository.
v0.2.0-alpha.6 - Fix repeated authorization prompts
Lark Agent Bridge v0.2.0-alpha.6
Fix repeated sign-in prompts when switching between AI-agent sign-in and Lark authorization.
Fixes
- Verify saved Lark credentials during setup. Cached CLI status omits verification flags; that is no longer treated as a missing login.
- Keep AI-agent sign-in and Lark authorization independent. Completing one sign-in checks that service without resetting the other connection.
- Preserve the newly authorized Lark account when saving a Settings screen opened before authorization completed.
- Keep Codex and Claude Code executable choices separate. Use the same configured executable for sign-in checks and worker tasks, including after restart.
- Check an unchecked connection before starting a test or worker. Report which service needs attention instead of asking users to repeat both authorizations.
- Preserve selected features during permission recovery and return to the appropriate authorization action.
Existing local settings, memories and credentials are retained. Quit the older app, install this update, then use Settings > Check connection. If credentials genuinely need renewal, sign in only to the service identified by the error. If the older version saved an empty Lark owner, reconnect the existing Lark account once. Ordinary AI-agent CLI login status does not prove that a later model/API request will succeed.
The optional feature picker from alpha 5 remains available. Selections control the next user authorization request, not a runtime tool allowlist. Unchecking a feature does not revoke previous Lark grants.
Downloads
Windows x64: EXE installer. Linux x64: AppImage or Debian/Ubuntu package. Mac with Apple Silicon ARM64: testing DMG or ZIP. Intel Mac builds are not included.
Important Mac testing information
The Mac build has an ad-hoc testing signature. It is not Apple Developer ID signed or notarized and does not pass Gatekeeper approval. DMG/ZIP signature verification and app tests do not replace Apple's approval. This is a testing build.
For macOS installation warnings, follow Apple's guidance: https://support.apple.com/en-us/102445. Follow your organization's installation policies. Windows testing builds are unsigned.
Verification and licences
The release workflow runs core regression tests, source desktop tests and packaged desktop/PDF tests on Windows, macOS and Linux. Mac validation also checks DMG/ZIP signatures and runs tests from the app copied out of the DMG. Regression coverage includes cached verification, independent provider sign-in, provider executable persistence, asynchronous account updates and pending-permission recovery.
These tests use fixtures. A read-only local diagnostic also verified the saved Codex and Lark connections; fresh live authorization on every user organization/provider is not covered by these tests.
See LICENSE.txt, THIRD_PARTY_NOTICES.md and SHA256SUMS.txt in Assets. The bridge's own code is proprietary; third-party licences remain applicable. Automatically generated Source code archives contain only the public download repository.
v0.2.0-alpha.5 - Selectable Lark features and clearer setup
Lark Agent Bridge v0.2.0-alpha.5
This testing update makes initial setup clearer and lets you choose which Lark features to authorize.
New in this build
- Choose optional user permissions for Documents & Drive, Sheets, Slides, Wiki, Base, Tasks, Calendar, Meetings & Minutes, Contacts and Email.
- Find OKR, Approvals and Attendance under More features. Selected items remain in the authorization summary when the group is collapsed.
- Optional features start unchecked on new profiles. Chat/account authorization remains required by the current bridge.
- Feature selection survives restart. Authorize changes before continuing setup or restarting the bot.
- Distinguish Computer access from Lark access in setup, Settings and Home. Read local files only controls local agent access. Lark access is authorized separately and also depends on agent command and network availability.
- Preserve missing-permission recovery details when authorization fails.
Selections control the next user authorization request, not a runtime tool allowlist. Unchecking a feature does not revoke existing grants. Existing profiles may already have broader access. Bot app permissions, administrator approval and individual resource access remain separate. Review Lark's exact consent screen: selected domains can include editing, deletion, sending mail or acting on approvals where supported.
Downloads
Windows x64: EXE installer. Linux x64: AppImage or Debian/Ubuntu package. Mac with Apple Silicon ARM64: testing DMG or ZIP. Intel Mac builds are not included.
Updates are manual. Quit the old app before installing and reopening this version. Existing local settings and memories are retained. Run setup again or use Settings to review feature choices. Keep the computer running the bridge awake and online.
Important Mac testing information
The Mac build has an ad-hoc testing signature. It is not Apple Developer ID signed or notarized and does not pass Gatekeeper approval. DMG/ZIP signature verification and app tests do not replace Apple's approval. This is a testing build, not a normal client-ready Mac distribution.
Install the DMG by dragging the app into Applications, replacing the old copy. For macOS installation warnings, follow Apple's guidance: https://support.apple.com/en-us/102445. Follow your organization's installation policies. If installation is blocked or reports damaged, report the macOS version and processor.
Windows testing builds are unsigned.
Validation and licences
Core tests, source desktop tests and packaged desktop/PDF tests run on Windows, macOS and Linux. Mac validation also checks the DMG, ZIP and the app copied out of the DMG. These fixture tests do not cover live Lark authorization against a real organization.
The bridge's own code is proprietary. Third-party components retain their respective licences. Assets include LICENSE.txt, THIRD_PARTY_NOTICES.md and SHA256SUMS.txt. Automatically generated Source code archives contain only this public download repository.
v0.2.0-alpha.4 - Folder support and Mac test signing correction
Lark Agent Bridge v0.2.0-alpha.4
Testing update with expanded incoming attachment support and corrected Mac test-app signatures.
New in this build
- Read Markdown and plain-text attachments (.md, .markdown, .txt).
- Extract ZIP folders into a separate local directory and provide a file inventory to the agent.
- Handle folders uploaded directly in Lark: recursively list the folder and download its individual files using the original message.
- Reject unsafe archive paths, links, duplicate names, corrupted entries and oversized expansions. Download/preparation can be cancelled.
- Keep generated previews separate so they cannot overwrite files uploaded in a folder.
- Correct Mac test signatures; verify the DMG and ZIP contents and run the app tests after copying it out of the DMG.
Upload the file or folder, wait for "Attachment received and ready", then send your instruction. Please resend attachments that were rejected or ignored by an older version.
Downloads
Windows x64: .exe installer. Linux x64: AppImage or .deb. macOS Apple Silicon ARM64: testing DMG or ZIP. Intel Mac builds are not included.
Important Mac testing information
This Mac build has an ad-hoc signature. It is not Apple Developer ID signed or notarized, and it does not pass Gatekeeper approval. Signature verification and successful app tests do not replace Apple's approval. It is for voluntary testing, not a normal client-ready Mac distribution.
- Download the new DMG, open it, and drag the app into Applications, replacing the older app copy.
- Try opening the new app from Applications.
- If macOS blocks it and you trust this official download, System Settings > Privacy & Security may offer Open Anyway. Follow Apple's own instructions and approve only if you intend to test this app: https://support.apple.com/en-us/102445
- If the new build still reports "damaged", or macOS does not offer approval, stop and report the macOS version and processor. Managed Macs may not permit exceptions.
No system-wide security disabling or quarantine-removal commands are required or provided. A normal public Mac release still needs an Apple Developer Program account, Developer ID signing and notarization.
Processing limits
30 MB per incoming download; Markdown/text decoding up to 8 MB. ZIP: at most 400 entries/200 files, 20 MB per extracted file and 80 MB expanded total. Native folders: up to 200 files, 30 MB per file and 80 MB total, with a four-minute download budget. Supported members receive bounded previews; the complete file inventory remains available to the agent. Nested ZIPs are not automatically expanded.
The computer running the bridge must remain awake and online. Updates are manual. Windows testing builds are unsigned. Existing local settings and memories are retained.
The bridge's own code is proprietary; third-party components retain their own licences. See LICENSE.txt, THIRD_PARTY_NOTICES.md and SHA256SUMS.txt in Assets. The automatically generated Source code archives contain only this public download repository.
v0.2.0-alpha.2 - Desktop testing release
Mac alpha.2 signing issue: Use v0.2.0-alpha.4 for corrected test signatures and expanded attachment support. The Mac testing app is still not Apple-notarized; read the new release notes before installing.
# Lark Agent Bridge v0.2.0-alpha.2
An early desktop testing release for connecting your Lark bot to Codex or Claude Code on your own computer.
Download
Choose your operating system and processor under Assets:
- Windows x64: .exe installer
- macOS Apple Silicon (ARM64): .dmg installer, or .zip
- Linux x64: .AppImage or .deb
The automatically generated Source code archives contain only the public download repository. Download an installer instead.
Included
- Guided setup for your agent, Lark bot, work folder and first message
- Home screen with connection and task status
- PDF/image inputs and generated file replies
- Persistent memories and reusable workflow skills
- Task cancellation, background operation and rate-limit recovery
- Reviewed switching from an older local bridge
You need an installed and signed-in Codex CLI or Claude Code and your own Lark account. Lark may require administrator approval for bot permissions. Keep the computer awake and online while listening.
These testing builds are unsigned. Managed computers may require administrator approval. Automatic updates are not included; install a newer release manually. Existing local settings and memories are retained.
The bridge's own code is proprietary. See LICENSE.txt and THIRD_PARTY_NOTICES.md; third-party components retain their own licences. SHA256SUMS.txt lists installer and notice-file checksums.