Skip to content

FocusWith v0.5.1 — Web, AI, MCP & Android

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 19 Jul 04:51
v0.5.1
39d30dc

FocusWith v0.5.1 — Web, AI, MCP & Android

FocusWith is a private-by-default, self-hosted focus system. The Android APK is an optional phone companion—not the whole product.

FocusWith 是一套默认私密、可自托管的完整专注系统。Android APK 只是可选的手机伴侣，并不是整个项目。

Choose how you want to use FocusWith

1. Web app and built-in AI companion

Run the FocusWith server to use directions, projects, tasks, timers, daily/weekly statistics, plan import, and the browser-based Companion.

网页端包含方向、项目、任务、专注计时、每日／每周统计、计划导入和 AI 陪伴页面。

The built-in Companion supports:

  • OpenAI Responses API
  • Anthropic / Claude API
  • DeepSeek
  • GLM / Zhipu
  • Ollama and other OpenAI-compatible endpoints

Install from source:

git clone https://github.com/sayhi2e10414-cpu/focus-with.git
cd focus-with
./scripts/install.sh
./scripts/focus start

You can also download Source code (zip) below. Provider keys stay on the FocusWith server in the ignored .env file and are never embedded in browser JavaScript.

2. Local MCP and secure Remote MCP

FocusWith exposes seven scoped tools for starting and completing focus sessions, reading plans, managing tasks, and choosing the next action.

  • Local MCP: Codex, Claude Desktop/Code, and other stdio MCP clients can use scripts/focus-mcp.
  • Remote MCP: Claude.ai and compatible ChatGPT workspaces can connect to the public HTTPS /mcp endpoint through OAuth, DCR, and S256 PKCE.

The AI model lives in the MCP client; it does not depend on the Android app or the built-in Companion provider.

3. Android companion

The optional Android app adds:

  • selected-app usage-event monitoring;
  • screen-off false-positive protection;
  • a persistent timer notification;
  • an optional draggable overlay timer;
  • phone-scoped access that cannot read AI keys, OAuth tokens, or the full Focus API.

Download FocusWith-Android-v0.5.1.apk below. The APK is signed and its .sha256 checksum is included.

4. iPhone, Telegram, and macOS

The same server also includes iPhone Shortcut event endpoints, optional Telegram button messages, and the native macOS floating timer source.

Important notes

  • FocusWith currently targets one owner per deployment.
  • Remote MCP and model providers remain off until explicitly configured.
  • Back up the SQLite database or Docker volume before upgrading.
  • Android may ask users to allow installation from GitHub because the APK is distributed outside Google Play.
  • Users who installed the earlier debug APK must uninstall it once before installing the signed release.

Documentation

v0.5.1 includes all features introduced in v0.3.x and v0.4.x; users do not need to install those versions separately.

Assets 4
Loading