Long coding sessions benefit from small breaks that do not pull you into another app. otak-zen keeps the pause inside VS Code: click the 禅 status bar item, watch a full-panel canvas animation, feed the fish with a click, then click again when you are ready to return.

Quick Start

1. Install from the VS Code Marketplace.
2. Click the 禅 item in the VS Code status bar.
3. Move the pointer across the canvas to influence the fish.
4. Click the canvas to add food bursts.
5. Click 禅 again to close the Zen Time panel.

You can also run Toggle Zen Time from the Command Palette.

Capabilities

• Status bar toggle: the 禅 item opens and closes the Zen Time Webview.
• Interactive canvas: koi and smaller creatures swim across a full-panel HTML5 canvas.
• Click-to-feed motion: clicking the canvas creates food particles that fish can chase.
• Pointer-aware behavior: fish respond to pointer movement, producing a more organic scene.
• Live settings updates: changing creature counts in VS Code settings updates the open panel.
• Bounded simulation work: food particles and neighbor lookups are bounded to keep animation cost controlled.
• Local-only experience: all rendering runs in the VS Code Webview on your machine.
• Package localization: Marketplace/package metadata, command title, and settings descriptions follow supported VS Code display languages.

How It Works

When VS Code finishes starting, otak-zen creates a status bar item labeled 禅. Activating it:

1. Opens a Zen Time Webview panel.
2. Loads the packaged canvas app from src/zen/.
3. Applies a nonce-based content security policy for the Webview script.
4. Sends the current otakZen settings to the Webview after it is ready.
5. Re-sends settings when you change otakZen.smallCreatureCount or otakZen.koiCount.

The Webview stops its animation loop when hidden and resumes when visible again.

Controls

Settings

Supported Scenarios

Security & Privacy

otak-zen is designed to stay local and quiet.

• 100% local rendering: the fish scene runs inside the VS Code Webview.
• Zero network access: no remote images, APIs, analytics, or telemetry calls are used.
• No account or API key: nothing to sign in to, nothing to provision.
• No workspace file writes: the extension reads its packaged Webview files and does not modify your project files.
• Content security policy: the Webview uses a generated nonce for script loading.
• Open source, MIT-licensed: the implementation is auditable on GitHub.

Package Localization

The extension manifest follows your VS Code display language for package-visible text:

English · 日本語 · 简体中文 · 繁體中文 · 한국어 · Tiếng Việt · Español · Português (BR) · Français · Deutsch · हिन्दी · Bahasa Indonesia · Italiano · Русский · العربية · Türkçe

This README is intentionally kept in English only.

Requirements

• VS Code 1.90.0 or newer
• Webview support enabled in VS Code

Installation

Install from the VS Code Marketplace, or run:

ext install odangoo.otak-zen

npm install
npm run package
code --install-extension otak-zen-1.3.3.vsix

Troubleshooting

• The 禅 item is missing: reload VS Code and confirm the extension is enabled.
• The panel opens but looks blank: reload the window and check whether Webviews are disabled by policy.
• The animation feels heavy: reduce otakZen.smallCreatureCount or otakZen.koiCount.
• Settings did not appear to apply: close and reopen Zen Time after changing the setting.
• You expected VS Code's built-in Zen Mode: otak-zen is a visual Webview break, not a layout-hiding command.

Related Extensions

More VS Code extensions by odangoo:

License

Released under the MIT License.