Security advisory — Malicious litellm versions 1.82.7 and 1.82.8 were removed from PyPI (potential API key exfiltration). Uninstall them, rotate exposed credentials, and upgrade to a safe release (e.g. 1.82.9+). Run pip show litellm to verify. PyPI · README

Near Desktop

Local-first workspace: Electron UI on top of a local agx serve.

Near is the desktop workspace. It is Electron + React + Zustand + Vite. It is not a second agent runtime. The default path starts a local agx serve / agx-server and talks REST + SSE.

Use Near when you want multi-pane chat, avatars, group chat, a workspace, a terminal, automation, and Voice Focus on your machine. Do not use it as a hosted multi-tenant portal — that is Enterprise.

Near Desktop architecture

Boot path

Diagram: spawn local agx serve, write port/token, then REST + SSE.

Desktop binds the local backend. A remote agx serve mode is not the default product path. After a successful start, the real port and AGX_DESKTOP_TOKEN are written under ~/.agenticx/.

What ships

  • Panes: one session per pane; model choice is per pane, not a global override
  • Meta-Agent: unnamed chat goes to Meta; @name routes to that avatar
  • Group chat: Meta is always a member; smart routing, no mandatory orchestrator picker
  • Workspace: folders bind per avatar / Meta; @file inserts a token with an absolute sourcePath
  • Tools: MCP, Skills, Hooks, Computer Use, local knowledge brains
  • Automation: scheduled runs use avatar_id like automation:<task_id> and must not leak into Meta history
  • Voice Focus: 280×280 capsule; Meta answers; transcript lands in the current Meta session

Session restore

Closing a pane and opening the same avatar should return the last session, not a new one. After lid close / relaunch, panes and the last sessions should come back from local workspace state.

Worked example: two panes and an @file

Scene. You are reviewing a repo with Meta, then hand a file to a researcher avatar.

  1. Open Near. Confirm ~/.agenticx/serve.port is live.
  2. Keep Meta in the first pane. Ask it to outline the review.
  3. Open the researcher avatar in a second pane (or @ them in a group). Model choice stays on that pane.
  4. In the workspace panel, bind the repo folder to that avatar. Click a file so the input inserts an @file[name](absolute path) token. sourcePath must stay absolute.
  5. Send. The avatar should call file_read / liteparse on the real path, not only ~/.agenticx/avatars/<id>/workspace.

What you should see. Two panes, independent model pills, a blue file token above or inside the input, a folded tool card, then an answer. Closing the avatar pane and reopening it should restore this session, not create a blank one.

Two Near panes with Meta and a researcher avatar
Near: the meta pane on the left, a named expert pane on the right.

Related