From 967704a9b9b2db73db3e6fa5cc3a787e6b9359e0 Mon Sep 17 00:00:00 2001 From: Bohdan Triapitsyn Date: Sun, 24 May 2026 14:15:55 +0300 Subject: [PATCH] docs: add OpenChamber feature docs and translations (#1400) * docs: add OpenChamber feature docs and translations Add 30 new docs pages covering OpenChamber-specific workflows and setup: OpenCode server, providers/models/agents, MCP, skills, commands & snippets, usage, projects, context, notes/todos/plans, scheduled tasks, project actions, preview, worktrees, multi-run, git & GitHub, magic prompts, git identities, mobile/PWA, security, notifications, voice, project icons, remote instances, desktop browser, updates, and three troubleshooting pages. Rebuild sidebar into eight task-oriented sections and translate every new page into all six supported locales (uk, zh-cn, es, pt-br, ko, pl). * docs: surface new sections on homepage and cross-link tunnels Add an Explore block to the docs homepage (all seven locales) linking to the new section anchors, and cross-link the Tunnels page to Security and PWA & Mobile. --- .../docs/content/docs/commands-snippets.mdx | 39 ++ packages/docs/content/docs/context.mdx | 38 ++ .../docs/content/docs/desktop-browser.mdx | 22 + .../content/docs/es/commands-snippets.mdx | 39 ++ packages/docs/content/docs/es/context.mdx | 38 ++ .../docs/content/docs/es/desktop-browser.mdx | 22 + .../docs/content/docs/es/git-identities.mdx | 30 ++ packages/docs/content/docs/es/git.mdx | 41 ++ packages/docs/content/docs/es/github.mdx | 34 ++ packages/docs/content/docs/es/index.mdx | 7 + .../docs/content/docs/es/magic-prompts.mdx | 26 ++ packages/docs/content/docs/es/mcp.mdx | 30 ++ packages/docs/content/docs/es/mobile.mdx | 31 ++ packages/docs/content/docs/es/multi-run.mdx | 34 ++ .../content/docs/es/notes-todos-plans.mdx | 37 ++ .../docs/content/docs/es/notifications.mdx | 34 ++ .../docs/content/docs/es/opencode-server.mdx | 54 +++ packages/docs/content/docs/es/preview.mdx | 32 ++ .../docs/content/docs/es/project-actions.mdx | 28 ++ .../docs/content/docs/es/project-icons.mdx | 20 + packages/docs/content/docs/es/projects.mdx | 34 ++ packages/docs/content/docs/es/providers.mdx | 49 ++ .../docs/content/docs/es/remote-instances.mdx | 30 ++ .../docs/content/docs/es/scheduled-tasks.mdx | 33 ++ packages/docs/content/docs/es/security.mdx | 37 ++ .../docs/content/docs/es/skills-catalog.mdx | 27 ++ packages/docs/content/docs/es/skills.mdx | 30 ++ .../troubleshooting/opencode-connection.mdx | 34 ++ .../docs/es/troubleshooting/remote-access.mdx | 38 ++ .../docs/es/troubleshooting/worktrees-git.mdx | 35 ++ packages/docs/content/docs/es/tunnels.mdx | 2 + packages/docs/content/docs/es/updates.mdx | 31 ++ packages/docs/content/docs/es/usage.mdx | 28 ++ packages/docs/content/docs/es/voice.mdx | 36 ++ packages/docs/content/docs/es/worktrees.mdx | 36 ++ packages/docs/content/docs/git-identities.mdx | 30 ++ packages/docs/content/docs/git.mdx | 41 ++ packages/docs/content/docs/github.mdx | 34 ++ packages/docs/content/docs/index.mdx | 7 + .../content/docs/ko/commands-snippets.mdx | 39 ++ packages/docs/content/docs/ko/context.mdx | 38 ++ .../docs/content/docs/ko/desktop-browser.mdx | 22 + .../docs/content/docs/ko/git-identities.mdx | 30 ++ packages/docs/content/docs/ko/git.mdx | 41 ++ packages/docs/content/docs/ko/github.mdx | 34 ++ packages/docs/content/docs/ko/index.mdx | 7 + .../docs/content/docs/ko/magic-prompts.mdx | 26 ++ packages/docs/content/docs/ko/mcp.mdx | 30 ++ packages/docs/content/docs/ko/mobile.mdx | 31 ++ packages/docs/content/docs/ko/multi-run.mdx | 34 ++ .../content/docs/ko/notes-todos-plans.mdx | 37 ++ .../docs/content/docs/ko/notifications.mdx | 34 ++ .../docs/content/docs/ko/opencode-server.mdx | 54 +++ packages/docs/content/docs/ko/preview.mdx | 32 ++ .../docs/content/docs/ko/project-actions.mdx | 28 ++ .../docs/content/docs/ko/project-icons.mdx | 20 + packages/docs/content/docs/ko/projects.mdx | 34 ++ packages/docs/content/docs/ko/providers.mdx | 49 ++ .../docs/content/docs/ko/remote-instances.mdx | 30 ++ .../docs/content/docs/ko/scheduled-tasks.mdx | 33 ++ packages/docs/content/docs/ko/security.mdx | 37 ++ .../docs/content/docs/ko/skills-catalog.mdx | 27 ++ packages/docs/content/docs/ko/skills.mdx | 30 ++ .../troubleshooting/opencode-connection.mdx | 34 ++ .../docs/ko/troubleshooting/remote-access.mdx | 38 ++ .../docs/ko/troubleshooting/worktrees-git.mdx | 35 ++ packages/docs/content/docs/ko/tunnels.mdx | 2 + packages/docs/content/docs/ko/updates.mdx | 31 ++ packages/docs/content/docs/ko/usage.mdx | 28 ++ packages/docs/content/docs/ko/voice.mdx | 36 ++ packages/docs/content/docs/ko/worktrees.mdx | 36 ++ packages/docs/content/docs/magic-prompts.mdx | 26 ++ packages/docs/content/docs/mcp.mdx | 30 ++ packages/docs/content/docs/mobile.mdx | 31 ++ packages/docs/content/docs/multi-run.mdx | 34 ++ .../docs/content/docs/notes-todos-plans.mdx | 37 ++ packages/docs/content/docs/notifications.mdx | 34 ++ .../docs/content/docs/opencode-server.mdx | 54 +++ .../content/docs/pl/commands-snippets.mdx | 39 ++ packages/docs/content/docs/pl/context.mdx | 38 ++ .../docs/content/docs/pl/desktop-browser.mdx | 22 + .../docs/content/docs/pl/git-identities.mdx | 30 ++ packages/docs/content/docs/pl/git.mdx | 41 ++ packages/docs/content/docs/pl/github.mdx | 34 ++ packages/docs/content/docs/pl/index.mdx | 7 + .../docs/content/docs/pl/magic-prompts.mdx | 26 ++ packages/docs/content/docs/pl/mcp.mdx | 30 ++ packages/docs/content/docs/pl/mobile.mdx | 31 ++ packages/docs/content/docs/pl/multi-run.mdx | 32 ++ .../content/docs/pl/notes-todos-plans.mdx | 37 ++ .../docs/content/docs/pl/notifications.mdx | 34 ++ .../docs/content/docs/pl/opencode-server.mdx | 54 +++ packages/docs/content/docs/pl/preview.mdx | 32 ++ .../docs/content/docs/pl/project-actions.mdx | 28 ++ .../docs/content/docs/pl/project-icons.mdx | 20 + packages/docs/content/docs/pl/projects.mdx | 34 ++ packages/docs/content/docs/pl/providers.mdx | 49 ++ .../docs/content/docs/pl/remote-instances.mdx | 30 ++ .../docs/content/docs/pl/scheduled-tasks.mdx | 33 ++ packages/docs/content/docs/pl/security.mdx | 37 ++ .../docs/content/docs/pl/skills-catalog.mdx | 27 ++ packages/docs/content/docs/pl/skills.mdx | 30 ++ .../troubleshooting/opencode-connection.mdx | 34 ++ .../docs/pl/troubleshooting/remote-access.mdx | 38 ++ .../docs/pl/troubleshooting/worktrees-git.mdx | 35 ++ packages/docs/content/docs/pl/tunnels.mdx | 2 + packages/docs/content/docs/pl/updates.mdx | 31 ++ packages/docs/content/docs/pl/usage.mdx | 28 ++ packages/docs/content/docs/pl/voice.mdx | 36 ++ packages/docs/content/docs/pl/worktrees.mdx | 36 ++ packages/docs/content/docs/preview.mdx | 32 ++ .../docs/content/docs/project-actions.mdx | 28 ++ packages/docs/content/docs/project-icons.mdx | 20 + packages/docs/content/docs/projects.mdx | 34 ++ packages/docs/content/docs/providers.mdx | 49 ++ .../content/docs/pt-br/commands-snippets.mdx | 39 ++ packages/docs/content/docs/pt-br/context.mdx | 38 ++ .../content/docs/pt-br/desktop-browser.mdx | 22 + .../content/docs/pt-br/git-identities.mdx | 30 ++ packages/docs/content/docs/pt-br/git.mdx | 41 ++ packages/docs/content/docs/pt-br/github.mdx | 34 ++ packages/docs/content/docs/pt-br/index.mdx | 7 + .../docs/content/docs/pt-br/magic-prompts.mdx | 26 ++ packages/docs/content/docs/pt-br/mcp.mdx | 30 ++ packages/docs/content/docs/pt-br/mobile.mdx | 31 ++ .../docs/content/docs/pt-br/multi-run.mdx | 34 ++ .../content/docs/pt-br/notes-todos-plans.mdx | 37 ++ .../docs/content/docs/pt-br/notifications.mdx | 34 ++ .../content/docs/pt-br/opencode-server.mdx | 54 +++ packages/docs/content/docs/pt-br/preview.mdx | 32 ++ .../content/docs/pt-br/project-actions.mdx | 28 ++ .../docs/content/docs/pt-br/project-icons.mdx | 20 + packages/docs/content/docs/pt-br/projects.mdx | 34 ++ .../docs/content/docs/pt-br/providers.mdx | 49 ++ .../content/docs/pt-br/remote-instances.mdx | 30 ++ .../content/docs/pt-br/scheduled-tasks.mdx | 33 ++ packages/docs/content/docs/pt-br/security.mdx | 37 ++ .../content/docs/pt-br/skills-catalog.mdx | 27 ++ packages/docs/content/docs/pt-br/skills.mdx | 30 ++ .../troubleshooting/opencode-connection.mdx | 34 ++ .../pt-br/troubleshooting/remote-access.mdx | 38 ++ .../pt-br/troubleshooting/worktrees-git.mdx | 35 ++ packages/docs/content/docs/pt-br/tunnels.mdx | 2 + packages/docs/content/docs/pt-br/updates.mdx | 31 ++ packages/docs/content/docs/pt-br/usage.mdx | 28 ++ packages/docs/content/docs/pt-br/voice.mdx | 36 ++ .../docs/content/docs/pt-br/worktrees.mdx | 36 ++ .../docs/content/docs/remote-instances.mdx | 30 ++ .../docs/content/docs/scheduled-tasks.mdx | 33 ++ packages/docs/content/docs/security.mdx | 37 ++ packages/docs/content/docs/skills-catalog.mdx | 27 ++ packages/docs/content/docs/skills.mdx | 30 ++ .../troubleshooting/opencode-connection.mdx | 34 ++ .../docs/troubleshooting/remote-access.mdx | 38 ++ .../docs/troubleshooting/worktrees-git.mdx | 35 ++ packages/docs/content/docs/tunnels.mdx | 2 + .../content/docs/uk/commands-snippets.mdx | 39 ++ packages/docs/content/docs/uk/context.mdx | 38 ++ .../docs/content/docs/uk/desktop-browser.mdx | 22 + .../docs/content/docs/uk/git-identities.mdx | 30 ++ packages/docs/content/docs/uk/git.mdx | 41 ++ packages/docs/content/docs/uk/github.mdx | 34 ++ packages/docs/content/docs/uk/index.mdx | 7 + .../docs/content/docs/uk/magic-prompts.mdx | 26 ++ packages/docs/content/docs/uk/mcp.mdx | 30 ++ packages/docs/content/docs/uk/mobile.mdx | 31 ++ packages/docs/content/docs/uk/multi-run.mdx | 32 ++ .../content/docs/uk/notes-todos-plans.mdx | 37 ++ .../docs/content/docs/uk/notifications.mdx | 34 ++ .../docs/content/docs/uk/opencode-server.mdx | 54 +++ packages/docs/content/docs/uk/preview.mdx | 32 ++ .../docs/content/docs/uk/project-actions.mdx | 28 ++ .../docs/content/docs/uk/project-icons.mdx | 20 + packages/docs/content/docs/uk/projects.mdx | 34 ++ packages/docs/content/docs/uk/providers.mdx | 49 ++ .../docs/content/docs/uk/remote-instances.mdx | 30 ++ .../docs/content/docs/uk/scheduled-tasks.mdx | 33 ++ packages/docs/content/docs/uk/security.mdx | 37 ++ .../docs/content/docs/uk/skills-catalog.mdx | 27 ++ packages/docs/content/docs/uk/skills.mdx | 30 ++ .../troubleshooting/opencode-connection.mdx | 34 ++ .../docs/uk/troubleshooting/remote-access.mdx | 38 ++ .../docs/uk/troubleshooting/worktrees-git.mdx | 35 ++ packages/docs/content/docs/uk/tunnels.mdx | 2 + packages/docs/content/docs/uk/updates.mdx | 31 ++ packages/docs/content/docs/uk/usage.mdx | 28 ++ packages/docs/content/docs/uk/voice.mdx | 36 ++ packages/docs/content/docs/uk/worktrees.mdx | 36 ++ packages/docs/content/docs/updates.mdx | 31 ++ packages/docs/content/docs/usage.mdx | 28 ++ packages/docs/content/docs/voice.mdx | 36 ++ packages/docs/content/docs/worktrees.mdx | 36 ++ .../content/docs/zh-cn/commands-snippets.mdx | 39 ++ packages/docs/content/docs/zh-cn/context.mdx | 38 ++ .../content/docs/zh-cn/desktop-browser.mdx | 22 + .../content/docs/zh-cn/git-identities.mdx | 30 ++ packages/docs/content/docs/zh-cn/git.mdx | 41 ++ packages/docs/content/docs/zh-cn/github.mdx | 34 ++ packages/docs/content/docs/zh-cn/index.mdx | 7 + .../docs/content/docs/zh-cn/magic-prompts.mdx | 26 ++ packages/docs/content/docs/zh-cn/mcp.mdx | 30 ++ packages/docs/content/docs/zh-cn/mobile.mdx | 31 ++ .../docs/content/docs/zh-cn/multi-run.mdx | 34 ++ .../content/docs/zh-cn/notes-todos-plans.mdx | 37 ++ .../docs/content/docs/zh-cn/notifications.mdx | 34 ++ .../content/docs/zh-cn/opencode-server.mdx | 54 +++ packages/docs/content/docs/zh-cn/preview.mdx | 32 ++ .../content/docs/zh-cn/project-actions.mdx | 28 ++ .../docs/content/docs/zh-cn/project-icons.mdx | 20 + packages/docs/content/docs/zh-cn/projects.mdx | 34 ++ .../docs/content/docs/zh-cn/providers.mdx | 49 ++ .../content/docs/zh-cn/remote-instances.mdx | 30 ++ .../content/docs/zh-cn/scheduled-tasks.mdx | 33 ++ packages/docs/content/docs/zh-cn/security.mdx | 37 ++ .../content/docs/zh-cn/skills-catalog.mdx | 27 ++ packages/docs/content/docs/zh-cn/skills.mdx | 30 ++ .../troubleshooting/opencode-connection.mdx | 34 ++ .../zh-cn/troubleshooting/remote-access.mdx | 38 ++ .../zh-cn/troubleshooting/worktrees-git.mdx | 35 ++ packages/docs/content/docs/zh-cn/tunnels.mdx | 2 + packages/docs/content/docs/zh-cn/updates.mdx | 31 ++ packages/docs/content/docs/zh-cn/usage.mdx | 28 ++ packages/docs/content/docs/zh-cn/voice.mdx | 36 ++ .../docs/content/docs/zh-cn/worktrees.mdx | 36 ++ packages/docs/sidebar.config.json | 420 +++++++++++++++++- 225 files changed, 7523 insertions(+), 12 deletions(-) create mode 100644 packages/docs/content/docs/commands-snippets.mdx create mode 100644 packages/docs/content/docs/context.mdx create mode 100644 packages/docs/content/docs/desktop-browser.mdx create mode 100644 packages/docs/content/docs/es/commands-snippets.mdx create mode 100644 packages/docs/content/docs/es/context.mdx create mode 100644 packages/docs/content/docs/es/desktop-browser.mdx create mode 100644 packages/docs/content/docs/es/git-identities.mdx create mode 100644 packages/docs/content/docs/es/git.mdx create mode 100644 packages/docs/content/docs/es/github.mdx create mode 100644 packages/docs/content/docs/es/magic-prompts.mdx create mode 100644 packages/docs/content/docs/es/mcp.mdx create mode 100644 packages/docs/content/docs/es/mobile.mdx create mode 100644 packages/docs/content/docs/es/multi-run.mdx create mode 100644 packages/docs/content/docs/es/notes-todos-plans.mdx create mode 100644 packages/docs/content/docs/es/notifications.mdx create mode 100644 packages/docs/content/docs/es/opencode-server.mdx create mode 100644 packages/docs/content/docs/es/preview.mdx create mode 100644 packages/docs/content/docs/es/project-actions.mdx create mode 100644 packages/docs/content/docs/es/project-icons.mdx create mode 100644 packages/docs/content/docs/es/projects.mdx create mode 100644 packages/docs/content/docs/es/providers.mdx create mode 100644 packages/docs/content/docs/es/remote-instances.mdx create mode 100644 packages/docs/content/docs/es/scheduled-tasks.mdx create mode 100644 packages/docs/content/docs/es/security.mdx create mode 100644 packages/docs/content/docs/es/skills-catalog.mdx create mode 100644 packages/docs/content/docs/es/skills.mdx create mode 100644 packages/docs/content/docs/es/troubleshooting/opencode-connection.mdx create mode 100644 packages/docs/content/docs/es/troubleshooting/remote-access.mdx create mode 100644 packages/docs/content/docs/es/troubleshooting/worktrees-git.mdx create mode 100644 packages/docs/content/docs/es/updates.mdx create mode 100644 packages/docs/content/docs/es/usage.mdx create mode 100644 packages/docs/content/docs/es/voice.mdx create mode 100644 packages/docs/content/docs/es/worktrees.mdx create mode 100644 packages/docs/content/docs/git-identities.mdx create mode 100644 packages/docs/content/docs/git.mdx create mode 100644 packages/docs/content/docs/github.mdx create mode 100644 packages/docs/content/docs/ko/commands-snippets.mdx create mode 100644 packages/docs/content/docs/ko/context.mdx create mode 100644 packages/docs/content/docs/ko/desktop-browser.mdx create mode 100644 packages/docs/content/docs/ko/git-identities.mdx create mode 100644 packages/docs/content/docs/ko/git.mdx create mode 100644 packages/docs/content/docs/ko/github.mdx create mode 100644 packages/docs/content/docs/ko/magic-prompts.mdx create mode 100644 packages/docs/content/docs/ko/mcp.mdx create mode 100644 packages/docs/content/docs/ko/mobile.mdx create mode 100644 packages/docs/content/docs/ko/multi-run.mdx create mode 100644 packages/docs/content/docs/ko/notes-todos-plans.mdx create mode 100644 packages/docs/content/docs/ko/notifications.mdx create mode 100644 packages/docs/content/docs/ko/opencode-server.mdx create mode 100644 packages/docs/content/docs/ko/preview.mdx create mode 100644 packages/docs/content/docs/ko/project-actions.mdx create mode 100644 packages/docs/content/docs/ko/project-icons.mdx create mode 100644 packages/docs/content/docs/ko/projects.mdx create mode 100644 packages/docs/content/docs/ko/providers.mdx create mode 100644 packages/docs/content/docs/ko/remote-instances.mdx create mode 100644 packages/docs/content/docs/ko/scheduled-tasks.mdx create mode 100644 packages/docs/content/docs/ko/security.mdx create mode 100644 packages/docs/content/docs/ko/skills-catalog.mdx create mode 100644 packages/docs/content/docs/ko/skills.mdx create mode 100644 packages/docs/content/docs/ko/troubleshooting/opencode-connection.mdx create mode 100644 packages/docs/content/docs/ko/troubleshooting/remote-access.mdx create mode 100644 packages/docs/content/docs/ko/troubleshooting/worktrees-git.mdx create mode 100644 packages/docs/content/docs/ko/updates.mdx create mode 100644 packages/docs/content/docs/ko/usage.mdx create mode 100644 packages/docs/content/docs/ko/voice.mdx create mode 100644 packages/docs/content/docs/ko/worktrees.mdx create mode 100644 packages/docs/content/docs/magic-prompts.mdx create mode 100644 packages/docs/content/docs/mcp.mdx create mode 100644 packages/docs/content/docs/mobile.mdx create mode 100644 packages/docs/content/docs/multi-run.mdx create mode 100644 packages/docs/content/docs/notes-todos-plans.mdx create mode 100644 packages/docs/content/docs/notifications.mdx create mode 100644 packages/docs/content/docs/opencode-server.mdx create mode 100644 packages/docs/content/docs/pl/commands-snippets.mdx create mode 100644 packages/docs/content/docs/pl/context.mdx create mode 100644 packages/docs/content/docs/pl/desktop-browser.mdx create mode 100644 packages/docs/content/docs/pl/git-identities.mdx create mode 100644 packages/docs/content/docs/pl/git.mdx create mode 100644 packages/docs/content/docs/pl/github.mdx create mode 100644 packages/docs/content/docs/pl/magic-prompts.mdx create mode 100644 packages/docs/content/docs/pl/mcp.mdx create mode 100644 packages/docs/content/docs/pl/mobile.mdx create mode 100644 packages/docs/content/docs/pl/multi-run.mdx create mode 100644 packages/docs/content/docs/pl/notes-todos-plans.mdx create mode 100644 packages/docs/content/docs/pl/notifications.mdx create mode 100644 packages/docs/content/docs/pl/opencode-server.mdx create mode 100644 packages/docs/content/docs/pl/preview.mdx create mode 100644 packages/docs/content/docs/pl/project-actions.mdx create mode 100644 packages/docs/content/docs/pl/project-icons.mdx create mode 100644 packages/docs/content/docs/pl/projects.mdx create mode 100644 packages/docs/content/docs/pl/providers.mdx create mode 100644 packages/docs/content/docs/pl/remote-instances.mdx create mode 100644 packages/docs/content/docs/pl/scheduled-tasks.mdx create mode 100644 packages/docs/content/docs/pl/security.mdx create mode 100644 packages/docs/content/docs/pl/skills-catalog.mdx create mode 100644 packages/docs/content/docs/pl/skills.mdx create mode 100644 packages/docs/content/docs/pl/troubleshooting/opencode-connection.mdx create mode 100644 packages/docs/content/docs/pl/troubleshooting/remote-access.mdx create mode 100644 packages/docs/content/docs/pl/troubleshooting/worktrees-git.mdx create mode 100644 packages/docs/content/docs/pl/updates.mdx create mode 100644 packages/docs/content/docs/pl/usage.mdx create mode 100644 packages/docs/content/docs/pl/voice.mdx create mode 100644 packages/docs/content/docs/pl/worktrees.mdx create mode 100644 packages/docs/content/docs/preview.mdx create mode 100644 packages/docs/content/docs/project-actions.mdx create mode 100644 packages/docs/content/docs/project-icons.mdx create mode 100644 packages/docs/content/docs/projects.mdx create mode 100644 packages/docs/content/docs/providers.mdx create mode 100644 packages/docs/content/docs/pt-br/commands-snippets.mdx create mode 100644 packages/docs/content/docs/pt-br/context.mdx create mode 100644 packages/docs/content/docs/pt-br/desktop-browser.mdx create mode 100644 packages/docs/content/docs/pt-br/git-identities.mdx create mode 100644 packages/docs/content/docs/pt-br/git.mdx create mode 100644 packages/docs/content/docs/pt-br/github.mdx create mode 100644 packages/docs/content/docs/pt-br/magic-prompts.mdx create mode 100644 packages/docs/content/docs/pt-br/mcp.mdx create mode 100644 packages/docs/content/docs/pt-br/mobile.mdx create mode 100644 packages/docs/content/docs/pt-br/multi-run.mdx create mode 100644 packages/docs/content/docs/pt-br/notes-todos-plans.mdx create mode 100644 packages/docs/content/docs/pt-br/notifications.mdx create mode 100644 packages/docs/content/docs/pt-br/opencode-server.mdx create mode 100644 packages/docs/content/docs/pt-br/preview.mdx create mode 100644 packages/docs/content/docs/pt-br/project-actions.mdx create mode 100644 packages/docs/content/docs/pt-br/project-icons.mdx create mode 100644 packages/docs/content/docs/pt-br/projects.mdx create mode 100644 packages/docs/content/docs/pt-br/providers.mdx create mode 100644 packages/docs/content/docs/pt-br/remote-instances.mdx create mode 100644 packages/docs/content/docs/pt-br/scheduled-tasks.mdx create mode 100644 packages/docs/content/docs/pt-br/security.mdx create mode 100644 packages/docs/content/docs/pt-br/skills-catalog.mdx create mode 100644 packages/docs/content/docs/pt-br/skills.mdx create mode 100644 packages/docs/content/docs/pt-br/troubleshooting/opencode-connection.mdx create mode 100644 packages/docs/content/docs/pt-br/troubleshooting/remote-access.mdx create mode 100644 packages/docs/content/docs/pt-br/troubleshooting/worktrees-git.mdx create mode 100644 packages/docs/content/docs/pt-br/updates.mdx create mode 100644 packages/docs/content/docs/pt-br/usage.mdx create mode 100644 packages/docs/content/docs/pt-br/voice.mdx create mode 100644 packages/docs/content/docs/pt-br/worktrees.mdx create mode 100644 packages/docs/content/docs/remote-instances.mdx create mode 100644 packages/docs/content/docs/scheduled-tasks.mdx create mode 100644 packages/docs/content/docs/security.mdx create mode 100644 packages/docs/content/docs/skills-catalog.mdx create mode 100644 packages/docs/content/docs/skills.mdx create mode 100644 packages/docs/content/docs/troubleshooting/opencode-connection.mdx create mode 100644 packages/docs/content/docs/troubleshooting/remote-access.mdx create mode 100644 packages/docs/content/docs/troubleshooting/worktrees-git.mdx create mode 100644 packages/docs/content/docs/uk/commands-snippets.mdx create mode 100644 packages/docs/content/docs/uk/context.mdx create mode 100644 packages/docs/content/docs/uk/desktop-browser.mdx create mode 100644 packages/docs/content/docs/uk/git-identities.mdx create mode 100644 packages/docs/content/docs/uk/git.mdx create mode 100644 packages/docs/content/docs/uk/github.mdx create mode 100644 packages/docs/content/docs/uk/magic-prompts.mdx create mode 100644 packages/docs/content/docs/uk/mcp.mdx create mode 100644 packages/docs/content/docs/uk/mobile.mdx create mode 100644 packages/docs/content/docs/uk/multi-run.mdx create mode 100644 packages/docs/content/docs/uk/notes-todos-plans.mdx create mode 100644 packages/docs/content/docs/uk/notifications.mdx create mode 100644 packages/docs/content/docs/uk/opencode-server.mdx create mode 100644 packages/docs/content/docs/uk/preview.mdx create mode 100644 packages/docs/content/docs/uk/project-actions.mdx create mode 100644 packages/docs/content/docs/uk/project-icons.mdx create mode 100644 packages/docs/content/docs/uk/projects.mdx create mode 100644 packages/docs/content/docs/uk/providers.mdx create mode 100644 packages/docs/content/docs/uk/remote-instances.mdx create mode 100644 packages/docs/content/docs/uk/scheduled-tasks.mdx create mode 100644 packages/docs/content/docs/uk/security.mdx create mode 100644 packages/docs/content/docs/uk/skills-catalog.mdx create mode 100644 packages/docs/content/docs/uk/skills.mdx create mode 100644 packages/docs/content/docs/uk/troubleshooting/opencode-connection.mdx create mode 100644 packages/docs/content/docs/uk/troubleshooting/remote-access.mdx create mode 100644 packages/docs/content/docs/uk/troubleshooting/worktrees-git.mdx create mode 100644 packages/docs/content/docs/uk/updates.mdx create mode 100644 packages/docs/content/docs/uk/usage.mdx create mode 100644 packages/docs/content/docs/uk/voice.mdx create mode 100644 packages/docs/content/docs/uk/worktrees.mdx create mode 100644 packages/docs/content/docs/updates.mdx create mode 100644 packages/docs/content/docs/usage.mdx create mode 100644 packages/docs/content/docs/voice.mdx create mode 100644 packages/docs/content/docs/worktrees.mdx create mode 100644 packages/docs/content/docs/zh-cn/commands-snippets.mdx create mode 100644 packages/docs/content/docs/zh-cn/context.mdx create mode 100644 packages/docs/content/docs/zh-cn/desktop-browser.mdx create mode 100644 packages/docs/content/docs/zh-cn/git-identities.mdx create mode 100644 packages/docs/content/docs/zh-cn/git.mdx create mode 100644 packages/docs/content/docs/zh-cn/github.mdx create mode 100644 packages/docs/content/docs/zh-cn/magic-prompts.mdx create mode 100644 packages/docs/content/docs/zh-cn/mcp.mdx create mode 100644 packages/docs/content/docs/zh-cn/mobile.mdx create mode 100644 packages/docs/content/docs/zh-cn/multi-run.mdx create mode 100644 packages/docs/content/docs/zh-cn/notes-todos-plans.mdx create mode 100644 packages/docs/content/docs/zh-cn/notifications.mdx create mode 100644 packages/docs/content/docs/zh-cn/opencode-server.mdx create mode 100644 packages/docs/content/docs/zh-cn/preview.mdx create mode 100644 packages/docs/content/docs/zh-cn/project-actions.mdx create mode 100644 packages/docs/content/docs/zh-cn/project-icons.mdx create mode 100644 packages/docs/content/docs/zh-cn/projects.mdx create mode 100644 packages/docs/content/docs/zh-cn/providers.mdx create mode 100644 packages/docs/content/docs/zh-cn/remote-instances.mdx create mode 100644 packages/docs/content/docs/zh-cn/scheduled-tasks.mdx create mode 100644 packages/docs/content/docs/zh-cn/security.mdx create mode 100644 packages/docs/content/docs/zh-cn/skills-catalog.mdx create mode 100644 packages/docs/content/docs/zh-cn/skills.mdx create mode 100644 packages/docs/content/docs/zh-cn/troubleshooting/opencode-connection.mdx create mode 100644 packages/docs/content/docs/zh-cn/troubleshooting/remote-access.mdx create mode 100644 packages/docs/content/docs/zh-cn/troubleshooting/worktrees-git.mdx create mode 100644 packages/docs/content/docs/zh-cn/updates.mdx create mode 100644 packages/docs/content/docs/zh-cn/usage.mdx create mode 100644 packages/docs/content/docs/zh-cn/voice.mdx create mode 100644 packages/docs/content/docs/zh-cn/worktrees.mdx diff --git a/packages/docs/content/docs/commands-snippets.mdx b/packages/docs/content/docs/commands-snippets.mdx new file mode 100644 index 00000000..58b2b6c5 --- /dev/null +++ b/packages/docs/content/docs/commands-snippets.mdx @@ -0,0 +1,39 @@ +--- +title: Commands & Snippets +description: Make reusable slash commands and text snippets for chat. +--- + +# Commands & Snippets + +Commands and snippets both save you from retyping the same thing. Commands are whole prompts you trigger with `/`; snippets are bits of text you drop into a message with `#`. + +## Commands + +A command is a saved prompt you run with a slash, like `/review`. Manage them at **Settings → Commands**. + +1. Open **Settings → Commands** and create a command. +2. Give it a name, a description, and the prompt text it should send. +3. Optionally pin it to a specific agent or model. +4. Choose personal or project scope. + +In chat, type `/` as the **first** character of the message to bring up commands, then pick one. Your text can use placeholders: + +- `$ARGUMENTS` — whatever you type after the command +- `@filename` — drops in the contents of a file +- `` !`command` `` — drops in the output of a shell command + +The built-in `init` and `review` commands can be reset but not deleted. + +## Snippets + +A snippet is reusable text you reference inline with a hashtag, like `#signoff`. Manage them at **Settings → Snippets**. + +1. Open **Settings → Snippets** and create a snippet. +2. Give it a name and the text it stands for. Add aliases if you want more than one trigger. +3. Choose personal or project scope. + +In chat, type `#` and pick a snippet. OpenChamber swaps in the full text before sending. + +## Related + +- [Skills](/skills/) — load larger instruction sets on demand diff --git a/packages/docs/content/docs/context.mdx b/packages/docs/content/docs/context.mdx new file mode 100644 index 00000000..f7cf2e8b --- /dev/null +++ b/packages/docs/content/docs/context.mdx @@ -0,0 +1,38 @@ +--- +title: Context +description: See how much of the model's memory a session is using. +--- + +# Context + +Every model can only hold so much of a conversation at once — its context. OpenChamber shows how full that is, so you can tell when a session is getting close to the limit and a reply might start dropping older detail. + +## The quick indicator + +While you chat, a small gauge shows the percentage of context used. It changes color as you fill up: + +- green — plenty of room +- yellow — getting full (around three-quarters) +- red — nearly full + +Hover it (or tap it on mobile) to see exact token counts. + +## The full context panel + +Open the **Context** tab in the right sidebar for a fuller picture of the current session: + +- the model in use and when the session started +- total tokens against the model's limit +- message and cost totals +- a breakdown of the last reply's tokens +- a rough split of what's taking up context (your messages, the agent's, tool output) + +The breakdown is an estimate, not an exact count — use it to spot what's filling the window, not for billing. + +## What to do when it's full + +Start a fresh session for a new task instead of letting one session grow forever. A shorter context is faster and keeps the model focused. + +## Related + +- [Projects](/projects/) — sessions are grouped per project diff --git a/packages/docs/content/docs/desktop-browser.mdx b/packages/docs/content/docs/desktop-browser.mdx new file mode 100644 index 00000000..e88b8ec2 --- /dev/null +++ b/packages/docs/content/docs/desktop-browser.mdx @@ -0,0 +1,22 @@ +--- +title: Desktop Browser +description: Browse any page inside the desktop app, with inspect and console capture. +--- + +# Desktop Browser + +The desktop app has a built-in browser so you can open any page right next to your chat, point at elements to ask about them, and capture the page's console. Open it from the globe button in the app header. + +> The desktop browser is a **desktop-only** feature. On the web, the [preview](/preview/) panel offers the same inspect-and-console tools for your local dev server. + +## Inspect and annotate + +Turn on **inspect** and click any element on the page. OpenChamber captures a note about it — what it is, its styles, where it sits, and a screenshot — and attaches it to your chat message. It's the quickest way to tell the agent "this element, right here." + +## Console capture + +The browser collects the page's console output — errors, warnings, and logs — so you can filter and read it without opening developer tools. + +## Related + +- [Preview & Dev Servers](/preview/) — the same tools for your local dev server diff --git a/packages/docs/content/docs/es/commands-snippets.mdx b/packages/docs/content/docs/es/commands-snippets.mdx new file mode 100644 index 00000000..7b451adf --- /dev/null +++ b/packages/docs/content/docs/es/commands-snippets.mdx @@ -0,0 +1,39 @@ +--- +title: Comandos y fragmentos +description: Crea comandos de barra y fragmentos de texto reutilizables para el chat. +--- + +# Comandos y fragmentos + +Los comandos y los fragmentos te ahorran reescribir lo mismo una y otra vez. Los comandos son prompts completos que activas con `/`; los fragmentos son trozos de texto que insertas en un mensaje con `#`. + +## Comandos + +Un comando es un prompt guardado que ejecutas con una barra, como `/review`. Gestiónalos en **Settings → Commands**. + +1. Abre **Settings → Commands** y crea un comando. +2. Dale un nombre, una descripción y el texto del prompt que debe enviar. +3. Opcionalmente, fíjalo a un agente o modelo concreto. +4. Elige el ámbito personal o de proyecto. + +En el chat, escribe `/` como **primer** carácter del mensaje para abrir los comandos y elige uno. Tu texto puede usar marcadores de posición: + +- `$ARGUMENTS` — lo que escribas después del comando +- `@filename` — inserta el contenido de un archivo +- `` !`command` `` — inserta la salida de un comando de shell + +Los comandos integrados `init` y `review` se pueden restablecer, pero no eliminar. + +## Fragmentos + +Un fragmento es texto reutilizable que referencias en línea con una almohadilla, como `#signoff`. Gestiónalos en **Settings → Snippets**. + +1. Abre **Settings → Snippets** y crea un fragmento. +2. Dale un nombre y el texto que representa. Añade alias si quieres más de un disparador. +3. Elige el ámbito personal o de proyecto. + +En el chat, escribe `#` y elige un fragmento. OpenChamber inserta el texto completo antes de enviar. + +## Relacionado + +- [Skills](/es/skills/) — carga conjuntos de instrucciones más grandes cuando los necesitas diff --git a/packages/docs/content/docs/es/context.mdx b/packages/docs/content/docs/es/context.mdx new file mode 100644 index 00000000..cfae821f --- /dev/null +++ b/packages/docs/content/docs/es/context.mdx @@ -0,0 +1,38 @@ +--- +title: Contexto +description: Mira cuánta memoria del modelo está usando una sesión. +--- + +# Contexto + +Cada modelo solo puede retener una parte de una conversación a la vez: su contexto. OpenChamber muestra qué tan lleno está, para que sepas cuándo una sesión se acerca al límite y una respuesta podría empezar a descartar detalles antiguos. + +## El indicador rápido + +Mientras chateas, un pequeño medidor muestra el porcentaje de contexto usado. Cambia de color a medida que se llena: + +- verde — espacio de sobra +- amarillo — llenándose (alrededor de tres cuartos) +- rojo — casi lleno + +Pasa el cursor por encima (o tócalo en el móvil) para ver el recuento exacto de tokens. + +## El panel de contexto completo + +Abre la pestaña **Context** en la barra lateral derecha para una imagen más completa de la sesión actual: + +- el modelo en uso y cuándo empezó la sesión +- el total de tokens frente al límite del modelo +- los totales de mensajes y coste +- un desglose de los tokens de la última respuesta +- una distribución aproximada de qué ocupa el contexto (tus mensajes, los del agente, la salida de herramientas) + +El desglose es una estimación, no un recuento exacto: úsalo para detectar qué está llenando la ventana, no para la facturación. + +## Qué hacer cuando está lleno + +Inicia una sesión nueva para una tarea nueva en lugar de dejar que una sola sesión crezca indefinidamente. Un contexto más corto es más rápido y mantiene al modelo enfocado. + +## Relacionado + +- [Proyectos](/es/projects/) — las sesiones se agrupan por proyecto diff --git a/packages/docs/content/docs/es/desktop-browser.mdx b/packages/docs/content/docs/es/desktop-browser.mdx new file mode 100644 index 00000000..c221a2a9 --- /dev/null +++ b/packages/docs/content/docs/es/desktop-browser.mdx @@ -0,0 +1,22 @@ +--- +title: Navegador de escritorio +description: Navega cualquier página dentro de la app de escritorio, con inspección y captura de consola. +--- + +# Navegador de escritorio + +La app de escritorio tiene un navegador integrado para que abras cualquier página justo al lado de tu chat, señales elementos para preguntar sobre ellos y captures la consola de la página. Ábrelo desde el botón del globo en el encabezado de la app. + +> El navegador de escritorio es una función **solo de escritorio**. En la web, el panel de [vista previa](/es/preview/) ofrece las mismas herramientas de inspección y consola para tu servidor de desarrollo local. + +## Inspecciona y anota + +Activa **inspect** y haz clic en cualquier elemento de la página. OpenChamber captura una nota sobre él —qué es, sus estilos, dónde se sitúa y una captura de pantalla— y la adjunta a tu mensaje del chat. Es la forma más rápida de decirle al agente "este elemento, justo aquí". + +## Captura de consola + +El navegador recopila la salida de la consola de la página —errores, advertencias y registros— para que puedas filtrarla y leerla sin abrir las herramientas de desarrollo. + +## Relacionado + +- [Vista previa y servidores de desarrollo](/es/preview/) — las mismas herramientas para tu servidor de desarrollo local diff --git a/packages/docs/content/docs/es/git-identities.mdx b/packages/docs/content/docs/es/git-identities.mdx new file mode 100644 index 00000000..dc303a87 --- /dev/null +++ b/packages/docs/content/docs/es/git-identities.mdx @@ -0,0 +1,30 @@ +--- +title: Identidades de Git +description: Haz commit con el nombre y correo correctos para cada repositorio. +--- + +# Identidades de Git + +Una identidad de git es el nombre y el correo con los que se firman tus commits. Si trabajas en repos personales y de trabajo, puedes guardar identidades y aplicar la correcta en cada repositorio, en lugar de depender de un único ajuste global. Gestiónalas en **Settings → Git**. + +## Añade una identidad + +1. Abre **Settings → Git** y elige **New**. +2. Introduce el **nombre** y el **correo** con los que harás commit. +3. Elige cómo se autentica con el remoto: + - **SSH** — apúntala a una clave SSH + - **token** — usa una credencial guardada para un host +4. Opcionalmente, dale un color y un icono para reconocerla fácilmente. + +La identidad global de tu sistema también se muestra, como solo lectura. + +## Aplica una identidad a un repo + +Al aplicar una identidad se escribe en la configuración **local** de git de ese repositorio: solo afecta a ese repo, no a tu ajuste global. Las identidades SSH también configuran el comando SSH para usar tu clave; las identidades de token configuran el almacenamiento de credenciales para el host. + +Puedes importar identidades que OpenChamber descubre a partir de tus credenciales de git existentes y guardarlas como identidades de token. + +## Relacionado + +- [Flujos de trabajo de Git y GitHub](/es/git/) — haz commit con la identidad que configures +- [Issues y PRs de GitHub](/es/github/) — conecta una cuenta de GitHub para los PRs diff --git a/packages/docs/content/docs/es/git.mdx b/packages/docs/content/docs/es/git.mdx new file mode 100644 index 00000000..37041e99 --- /dev/null +++ b/packages/docs/content/docs/es/git.mdx @@ -0,0 +1,41 @@ +--- +title: Flujos de trabajo de Git y GitHub +description: Prepara, confirma y gestiona ramas sin salir de OpenChamber. +--- + +# Flujos de trabajo de Git y GitHub + +OpenChamber tiene una vista de git integrada para que revises cambios, hagas commit y gestiones ramas sin cambiar a una terminal. Ábrela desde la pestaña **Git** en la barra lateral derecha. + +## Revisar y confirmar + +La vista de git divide tus cambios en **staged** y **unstaged**: + +- haz clic en el **+** de un archivo para prepararlo, o en **−** para quitarlo del área de preparación +- prepara o quita todo un grupo de una vez +- haz clic en un archivo para ver su diff + +Luego escribe un mensaje de commit y confirma. Puedes hacer que OpenChamber **genere un mensaje de commit** a partir de tus cambios preparados: usa el modelo de la sesión actual, así que necesitas una sesión abierta. + +## Ramas e historial + +La vista de git también cubre el resto del día a día de git: + +- crear, cambiar, renombrar y eliminar ramas +- push, pull y fetch +- explorar el historial y los diffs por commit +- guardar (stash) y restaurar cambios + +## Pull requests + +Conecta GitHub (consulta [Issues y PRs de GitHub](/es/github/)) y la pestaña **PR** te permite abrir un pull request, actualizarlo, marcarlo como listo o fusionarlo, y generar su título y descripción de la misma forma que los mensajes de commit. + +## Resolver conflictos + +Si una fusión, rebase o integración encuentra un conflicto, OpenChamber muestra qué está atascado y te deja resolverlo, incluso entregándoselo al agente. + +## Relacionado + +- [Issues y PRs de GitHub](/es/github/) — conecta GitHub y empieza a trabajar desde issues +- [Sesiones de worktree](/es/worktrees/) — aísla una rama en su propia carpeta +- [Identidades de Git](/es/git-identities/) — haz commit como la persona correcta en cada repo diff --git a/packages/docs/content/docs/es/github.mdx b/packages/docs/content/docs/es/github.mdx new file mode 100644 index 00000000..c4889e22 --- /dev/null +++ b/packages/docs/content/docs/es/github.mdx @@ -0,0 +1,34 @@ +--- +title: Issues y PRs de GitHub +description: Conecta GitHub e inicia sesiones desde issues y pull requests. +--- + +# Issues y PRs de GitHub + +Conecta tu cuenta de GitHub y OpenChamber podrá traer issues y pull requests, iniciar una sesión directamente desde uno, y abrir o actualizar PRs por ti. + +## Conecta GitHub + +1. Abre **Settings → Git**. +2. En GitHub, elige **Connect**. OpenChamber muestra un enlace y un código corto. +3. Abre el enlace, introduce el código y aprueba. + +Cuando esté conectado, tu cuenta aparece en la sección de GitHub. Puedes conectar más de una cuenta y cambiar entre ellas, o desconectar en cualquier momento. + +## Empieza a trabajar desde una issue o PR + +Cuando creas una [sesión de worktree](/es/worktrees/) con GitHub conectado, puedes elegir **Start from GitHub issue/PR**: + +- elige una **issue** y OpenChamber nombra la rama según ella y abre la sesión con la issue y sus comentarios como primer mensaje +- elige un **pull request** y hace checkout de la rama del PR; puedes incluir el diff del PR para que el agente tenga el cambio completo + +Esto te deja directamente en una sesión con el contexto ya cargado. + +## Abre y gestiona pull requests + +Desde la pestaña **PR** en la [vista de git](/es/git/), puedes crear un pull request, actualizarlo, marcar un borrador como listo o fusionarlo. OpenChamber puede generar el título y la descripción del PR a partir de tus cambios. + +## Relacionado + +- [Flujos de trabajo de Git y GitHub](/es/git/) — haz commit y gestiona ramas +- [Sesiones de worktree](/es/worktrees/) — donde empiezan las sesiones de issue y PR diff --git a/packages/docs/content/docs/es/index.mdx b/packages/docs/content/docs/es/index.mdx index fc43e251..4c76bbc0 100644 --- a/packages/docs/content/docs/es/index.mdx +++ b/packages/docs/content/docs/es/index.mdx @@ -20,6 +20,13 @@ Usa esta documentación para: - [Túneles](/es/tunnels/) - [Resolución de problemas](/es/troubleshooting/) +## Explora + +- [Proyectos](/es/projects/) y [Sesiones de worktree](/es/worktrees/) — organiza y aísla tu trabajo +- [Proveedores, modelos y agentes](/es/providers/) — conecta OpenCode y elige un modelo +- [Flujos de trabajo de Git y GitHub](/es/git/) — haz commits, revisa y abre PRs +- [Seguridad](/es/security/) y [Túneles](/es/tunnels/) — protege tu instancia y accede a ella + ## Para qué sirve OpenChamber OpenChamber está pensado para las partes de la programación con IA que se benefician de un centro de control: ramificar sesiones, revisar diffs, gestionar terminales, observar el progreso de las herramientas, ejecutar acciones de proyecto y mantener todo el panel a la vista mientras el agente trabaja. diff --git a/packages/docs/content/docs/es/magic-prompts.mdx b/packages/docs/content/docs/es/magic-prompts.mdx new file mode 100644 index 00000000..05a70599 --- /dev/null +++ b/packages/docs/content/docs/es/magic-prompts.mdx @@ -0,0 +1,26 @@ +--- +title: Magic Prompts +description: Personaliza los prompts integrados detrás de los flujos automatizados de OpenChamber. +--- + +# Magic Prompts + +OpenChamber usa prompts integrados en segundo plano cada vez que hace algo automáticamente: escribir un mensaje de commit, redactar un PR, revisar una issue, resolver un conflicto, resumir una sesión. Magic Prompts es donde lees y reescribes esos prompts. Ábrelo en **Settings → Magic Prompts**. + +No necesitas esta página para el uso normal. Recurre a ella cuando quieras que un flujo se comporte de otra manera; por ejemplo, mensajes de commit con un estilo particular. + +## Edita un prompt + +1. Abre **Settings → Magic Prompts**. +2. Elige un prompt de los grupos en la barra lateral: Git, GitHub, Planning y Session. +3. Edita el texto y guarda. + +Algunos prompts tienen una parte visible (el mensaje que verías) y una parte de instrucciones (guía oculta para el agente). Los prompts pueden incluir `{{placeholders}}` que OpenChamber rellena, como el diff o el título de la issue; mantenlos en su sitio. + +## Restablecer + +¿Cambiaste de opinión? Cada prompt tiene **reset to default**, y hay un **reset all** si quieres empezar de cero en todas partes. + +## Relacionado + +- [Flujos de trabajo de Git y GitHub](/es/git/) — muchos de estos prompts impulsan los flujos de git diff --git a/packages/docs/content/docs/es/mcp.mdx b/packages/docs/content/docs/es/mcp.mdx new file mode 100644 index 00000000..dedd731f --- /dev/null +++ b/packages/docs/content/docs/es/mcp.mdx @@ -0,0 +1,30 @@ +--- +title: Servidores MCP +description: Añade servidores MCP para dar herramientas extra a los agentes. +--- + +# Servidores MCP + +Un servidor MCP da a tus agentes herramientas adicionales: cosas como buscar en una base de datos, llamar a una API o leer un servicio que usas. Añádelos en **Settings → MCP**. + +## Añade un servidor + +1. Abre **Settings → MCP**. +2. Añade un servidor y elige su tipo: + - **local** — OpenChamber ejecuta un comando en tu máquina. Le das el comando que debe ejecutar y, si hace falta, variables de entorno. + - **remote** — OpenChamber se conecta a una URL que aloja otra persona. Le das la URL y cualquier encabezado que necesite (por ejemplo, un token de autenticación). +3. Guarda. El servidor está activo de forma predeterminada; puedes desactivarlo sin eliminarlo. + +## Dónde se aplica + +Elige el ámbito al añadir un servidor: + +- **personal** — disponible en todos los proyectos +- **proyecto** — disponible solo en el proyecto actual, y guardado junto con los demás ajustes del proyecto + +Los nombres de los servidores usan letras minúsculas, números, guiones y guiones bajos. + +## Relacionado + +- [Proveedores, modelos y agentes](/es/providers/) — conecta primero un modelo +- [Skills](/es/skills/) — otra forma de ampliar lo que pueden hacer los agentes diff --git a/packages/docs/content/docs/es/mobile.mdx b/packages/docs/content/docs/es/mobile.mdx new file mode 100644 index 00000000..e020f222 --- /dev/null +++ b/packages/docs/content/docs/es/mobile.mdx @@ -0,0 +1,31 @@ +--- +title: PWA y acceso móvil +description: Instala OpenChamber como una app y úsalo desde tu teléfono. +--- + +# PWA y acceso móvil + +La app web de OpenChamber se instala como una app de teléfono (una PWA), así que puedes tenerla en tu pantalla de inicio y usarla a pantalla completa. Combínala con un [túnel](/es/tunnels/) y podrás echar un vistazo a una sesión desde cualquier lugar. + +## Instálala + +OpenChamber usa la instalación integrada de tu navegador, así que no hay una descarga aparte: + +- **navegador de escritorio** — usa la opción **Install** en la barra de direcciones +- **iPhone/iPad (Safari)** — Compartir → **Añadir a pantalla de inicio** +- **Android (Chrome)** — menú → **Instalar app** / **Añadir a pantalla de inicio** + +Una vez instalada, se abre en su propia ventana sin los elementos del navegador. + +## Accede desde tu teléfono + +Para abrir OpenChamber en tu teléfono cuando el servidor se ejecuta en tu computadora, inicia un [túnel](/es/tunnels/) y abre el enlace (o escanea el código QR) en el teléfono. Usa una [contraseña de UI](/es/security/) fuerte siempre que lo hagas. + +## Ajustes móviles + +En **Settings → OpenChamber**, unas pocas opciones ajustan la experiencia móvil e instalada: el nombre con el que se instala la app, la orientación de la pantalla y cómo se comporta el teclado en pantalla. + +## Relacionado + +- [Túneles](/es/tunnels/) — accede a tu instancia desde otra red +- [Seguridad](/es/security/) — protege la UI antes de exponerla diff --git a/packages/docs/content/docs/es/multi-run.mdx b/packages/docs/content/docs/es/multi-run.mdx new file mode 100644 index 00000000..269976c5 --- /dev/null +++ b/packages/docs/content/docs/es/multi-run.mdx @@ -0,0 +1,34 @@ +--- +title: Multi-run +description: Ejecuta el mismo prompt en varios modelos o sesiones a la vez. +--- + +# Multi-run + +Multi-run lanza varias sesiones desde un solo formulario, útil para probar la misma tarea con distintos modelos y comparar los resultados. Ábrelo desde el botón en la parte superior de la barra lateral de sesiones. + +## Inicia un multi-run + +1. Abre el lanzador de multi-run. +2. Elige el proyecto y nombra el grupo de ejecución. +3. Escribe el prompt y elige los modelos con los que ejecutarlo (hasta cinco por grupo). +4. Elige si quieres **aislar las ejecuciones**. +5. Lanza. + +Cada modelo recibe su propia sesión, y todas empiezan con tu prompt. + +## Ejecuciones aisladas + +Activa **isolate runs** para dar a cada ejecución su propio [worktree](/es/worktrees/) y rama, de modo que nunca toquen los mismos archivos. Esto requiere un repositorio de git: se desactiva automáticamente en carpetas que no lo son. Elige la rama desde la que parten las ejecuciones. + +Con el aislamiento desactivado, cada ejecución es una sesión normal en la carpeta del proyecto. + +## Comparar resultados + +Cada ejecución es una sesión normal que puedes abrir, leer y conservar o descartar. Si iniciaste ejecuciones para comparar enfoques, revísalas en paralelo y lleva adelante el mejor. + +Si una sola ejecución no logra iniciarse, las demás se lanzan igualmente: simplemente verás menos sesiones de las que pediste. + +## Relacionado + +- [Sesiones de worktree](/es/worktrees/) — cómo funciona el aislamiento por dentro diff --git a/packages/docs/content/docs/es/notes-todos-plans.mdx b/packages/docs/content/docs/es/notes-todos-plans.mdx new file mode 100644 index 00000000..851a5fed --- /dev/null +++ b/packages/docs/content/docs/es/notes-todos-plans.mdx @@ -0,0 +1,37 @@ +--- +title: Notas, tareas y planes de proyecto +description: Mantén notas, una lista de tareas y planes guardados para cada proyecto. +--- + +# Notas, tareas y planes de proyecto + +Cada proyecto tiene su propio espacio de trabajo para notas, una lista de tareas y planes guardados. Pertenecen al proyecto, no a ninguna sesión concreta, así que permanecen mientras te mueves entre sesiones. Los encuentras en la pestaña **Context** de la barra lateral derecha (una pestaña dedicada en el móvil). + +## Notas + +Un cuadro de notas de formato libre para cualquier cosa que quieras recordar sobre el proyecto. Se guarda solo a medida que escribes. + +## Tareas + +Una lista de verificación sencilla. Añade elementos, márcalos como completados, reordénalos arrastrando y elimina los terminados. + +Cada tarea tiene un menú **send** para que se la entregues al agente: + +- enviarla a la sesión actual +- iniciar una sesión nueva con ella +- iniciar una nueva [sesión de worktree](/es/worktrees/) con ella (solo cuando el proyecto es un repositorio de git) + +## Planes + +Un lugar para guardar planes más largos como archivos. Puedes: + +- importar un plan desde un archivo Markdown o de texto +- abrir un plan para leerlo en el panel lateral +- eliminar los planes que ya no necesites + +Deberías volver a la pestaña Context con tu nota guardada, tu tarea marcada o tu plan listado: así sabes que funcionó. + +## Relacionado + +- [Sesiones de worktree](/es/worktrees/) — ejecuta una tarea en su propia rama +- [Proyectos](/es/projects/) — estos pertenecen al proyecto activo diff --git a/packages/docs/content/docs/es/notifications.mdx b/packages/docs/content/docs/es/notifications.mdx new file mode 100644 index 00000000..c7f59f74 --- /dev/null +++ b/packages/docs/content/docs/es/notifications.mdx @@ -0,0 +1,34 @@ +--- +title: Notificaciones +description: Recibe avisos cuando una sesión te necesita o termina. +--- + +# Notificaciones + +Las notificaciones te avisan cuando algo necesita tu atención para que no tengas que vigilar la pantalla: una sesión terminó, encontró un error, hizo una pregunta o necesita permiso para hacer algo. Configúralas en **Settings → OpenChamber → Notifications**. + +## Actívalas + +1. Abre **Settings → OpenChamber → Notifications**. +2. Permite las notificaciones cuando tu navegador o sistema lo pida. +3. Elige sobre qué quieres recibir avisos: + - una sesión **termina** + - una sesión encuentra un **error** + - una sesión **hace una pregunta** + - una sesión necesita **permiso** + - se completan **subtareas** + +## Cómo te llegan + +- en el **escritorio**, recibes notificaciones nativas del sistema +- en un **navegador o app instalada**, recibes notificaciones web push, así que llegan incluso cuando la pestaña está en segundo plano + +Las sesiones configuradas para aceptar automáticamente no te molestarán con notificaciones de permiso. + +## Personaliza el texto + +Cada tipo de notificación tiene una plantilla de título y mensaje que puedes editar, usando campos como el nombre del agente y el modelo. También hay un límite de cuánto del último mensaje se incluye, para que las notificaciones queden cortas. + +## Relacionado + +- [Modo de voz](/es/voice/) — escucha las respuestas leídas en voz alta diff --git a/packages/docs/content/docs/es/opencode-server.mdx b/packages/docs/content/docs/es/opencode-server.mdx new file mode 100644 index 00000000..278d579e --- /dev/null +++ b/packages/docs/content/docs/es/opencode-server.mdx @@ -0,0 +1,54 @@ +--- +title: OpenCode Server +description: Conecta OpenChamber a un servidor de OpenCode local o remoto. +--- + +# OpenCode Server + +OpenChamber se ejecuta sobre un servidor de OpenCode. De forma predeterminada inicia uno por ti, así que no tienes que hacer nada. Solo necesitas esta página si quieres apuntar OpenChamber a un servidor que ya ejecutas, o gestionar el que él inicia. + +## Cómo encuentra OpenChamber un servidor + +Cuando OpenChamber arranca, busca un servidor en este orden: + +1. reutilizar un servidor que ya inició +2. conectarse a uno externo si se lo indicaste (ver más abajo) +3. detectar automáticamente un servidor en el puerto predeterminado (`4096`) +4. de lo contrario, iniciar y gestionar el suyo propio + +Si no hay nada configurado, el paso 4 ocurre automáticamente y ya tienes todo en marcha. + +## Conéctate a un servidor que ya ejecutas + +Define esto antes de iniciar OpenChamber: + +```bash +OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber +``` + +- `OPENCODE_HOST` — la dirección completa de tu servidor de OpenCode, incluido el puerto (un valor como `http://localhost:4096`). No debe tener una ruta al final. +- `OPENCODE_SKIP_START=true` — le indica a OpenChamber que no inicie su propio servidor. + +Si solo necesitas cambiar el puerto, define `OPENCODE_PORT` en lugar de `OPENCODE_HOST`. + +Si a `OPENCODE_HOST` le falta el puerto o tiene una ruta, OpenChamber lo ignora y recurre a iniciar su propio servidor. Observa los registros de arranque por si aparece una advertencia `[config]` cuando una conexión que esperabas no ocurrió. + +## Gestiona el servidor desde la CLI + +```bash +openchamber status +openchamber logs +openchamber restart +openchamber stop +``` + +`openchamber` por sí solo inicia el servidor en segundo plano. Añade `--foreground` para mantenerlo asociado a tu terminal. + +## "OpenCode is restarting" + +Mientras el servidor se inicia o reinicia, OpenChamber muestra un estado "OpenCode is restarting" y pausa las solicitudes hasta que esté listo. Esto es normal justo después de iniciar o reiniciar. Si nunca desaparece, consulta [Conexión de OpenCode](/es/troubleshooting/opencode-connection/). + +## Relacionado + +- [Proveedores, modelos y agentes](/es/providers/) — configura con qué se comunica el servidor +- [Conexión de OpenCode](/es/troubleshooting/opencode-connection/) — si no se conecta diff --git a/packages/docs/content/docs/es/preview.mdx b/packages/docs/content/docs/es/preview.mdx new file mode 100644 index 00000000..e8684023 --- /dev/null +++ b/packages/docs/content/docs/es/preview.mdx @@ -0,0 +1,32 @@ +--- +title: Vista previa y servidores de desarrollo +description: Abre un servidor de desarrollo en marcha dentro de OpenChamber. +--- + +# Vista previa y servidores de desarrollo + +Cuando inicias un servidor de desarrollo, OpenChamber puede abrirlo dentro de la propia app en lugar de en una pestaña de navegador aparte, para que veas tu sitio junto al chat, captures su consola y señales elementos para preguntar sobre ellos. + +## Abre una vista previa + +OpenChamber observa la salida de la terminal en busca de una dirección local (la línea `Local:` que imprimen herramientas como Vite, Next.js o Astro). Cuando detecta una: + +- en la terminal aparece un botón **Open preview** +- una [acción de proyecto](/es/project-actions/) con la apertura automática activada la abre por ti +- un enlace local en un mensaje del chat también puede abrirla + +El sitio se carga en el panel lateral. Solo se pueden previsualizar direcciones locales (en tu propia máquina). + +## Consola e inspección + +En el panel de vista previa puedes: + +- ver la **consola** de la página —errores, advertencias y registros— filtrada como prefieras +- activar **inspect**, hacer clic en cualquier elemento y enviar una nota sobre él —selector, estilos, posición y una captura de pantalla— directamente al chat + +Esta es la forma más rápida de decirle al agente "este botón, aquí" sin describirlo. + +## Relacionado + +- [Acciones de proyecto](/es/project-actions/) — abre automáticamente un servidor al iniciarlo +- [Navegador de escritorio](/es/desktop-browser/) — las mismas herramientas para cualquier página, en el escritorio diff --git a/packages/docs/content/docs/es/project-actions.mdx b/packages/docs/content/docs/es/project-actions.mdx new file mode 100644 index 00000000..a7036656 --- /dev/null +++ b/packages/docs/content/docs/es/project-actions.mdx @@ -0,0 +1,28 @@ +--- +title: Acciones de proyecto +description: Guarda comandos que ejecutas a menudo y lánzalos con un solo clic. +--- + +# Acciones de proyecto + +Una acción de proyecto es un comando de shell que guardas una vez y ejecutas con un clic: tu servidor de desarrollo, una compilación, una ejecución de pruebas. Cada proyecto mantiene su propia lista. Configúralas en **Settings → Projects → Project Actions**. + +## Añade una acción + +1. Abre **Settings → Projects** y busca la sección **Project Actions**. +2. Añade una acción, dale un nombre, elige un icono e introduce el comando a ejecutar. +3. Guarda. + +Puedes limitar una acción a ciertos sistemas operativos si un comando solo tiene sentido en uno. + +## Ejecuta una acción + +Las acciones viven en un menú del encabezado de la app. Haz clic en una y OpenChamber la ejecuta en una terminal dentro de la carpeta de tu proyecto, cambiándote a la vista de terminal para que veas la salida. Deténla desde el mismo menú. + +## Abre automáticamente un servidor de desarrollo + +Activa **auto-open URL** para una acción que inicia un servidor. OpenChamber observa la salida en busca de una dirección local y se ofrece a abrirla; consulta [Vista previa y servidores de desarrollo](/es/preview/). En el escritorio también puedes enrutarla a través de un reenvío de puertos SSH. + +## Relacionado + +- [Vista previa y servidores de desarrollo](/es/preview/) — abre un servidor de desarrollo en marcha dentro de OpenChamber diff --git a/packages/docs/content/docs/es/project-icons.mdx b/packages/docs/content/docs/es/project-icons.mdx new file mode 100644 index 00000000..8dd192ec --- /dev/null +++ b/packages/docs/content/docs/es/project-icons.mdx @@ -0,0 +1,20 @@ +--- +title: Iconos de proyecto +description: Da a cada proyecto un icono reconocible. +--- + +# Iconos de proyecto + +Un icono de proyecto facilita distinguir tus proyectos de un vistazo. OpenChamber intenta encontrar uno por ti, y siempre puedes poner el tuyo. Gestiónalo en **Settings → Projects**. + +## Descubrimiento automático + +Cuando añades un proyecto, OpenChamber busca un archivo `favicon` dentro de él y lo usa como icono del proyecto. Si tu repo ya incluye un favicon, el icono normalmente aparece solo: no hay nada que hacer. + +## Pon el tuyo + +Abre **Settings → Projects** y sube una imagen (PNG, JPEG o SVG, hasta 5 MB). Una imagen personalizada tiene prioridad sobre la descubierta automáticamente. También puedes elegir un color en su lugar, o eliminar la imagen para volver al descubrimiento. + +## Relacionado + +- [Proyectos](/es/projects/) — nombra, da color y organiza tus proyectos diff --git a/packages/docs/content/docs/es/projects.mdx b/packages/docs/content/docs/es/projects.mdx new file mode 100644 index 00000000..dbb83547 --- /dev/null +++ b/packages/docs/content/docs/es/projects.mdx @@ -0,0 +1,34 @@ +--- +title: Proyectos +description: Organiza tu trabajo en proyectos y cambia entre ellos. +--- + +# Proyectos + +Un proyecto es una carpeta de tu computadora que OpenChamber rastrea, normalmente un único código base. Cambiar de proyecto cambia la carpeta en la que trabaja el agente, junto con las sesiones y los ajustes de ese proyecto. + +## Añade un proyecto + +Puedes añadir un proyecto desde varios lugares: + +- la entrada **Add project** en la paleta de comandos +- el botón **+** en la parte superior de la barra lateral de sesiones +- el explorador de carpetas cuando eliges un directorio + +Apúntalo a una carpeta y OpenChamber la recuerda. El nombre viene de la carpeta; puedes cambiarlo más tarde. + +## Cambia de proyecto + +Elige un proyecto de la barra lateral para activarlo. Todo —sesiones, git, notas— sigue al proyecto que tengas abierto. + +## Haz reconocible un proyecto + +Abre **Settings → Projects** para darle a un proyecto un nombre, color o icono personalizado. OpenChamber intenta encontrar un icono automáticamente; consulta [Iconos de proyecto](/es/project-icons/). + +> En VS Code, OpenChamber siempre usa la carpeta que tienes abierta como único proyecto, así que no hay nada que añadir ni cambiar. La página de ajustes de proyectos está oculta allí. + +## Relacionado + +- [Notas, tareas y planes de proyecto](/es/notes-todos-plans/) — mantén notas de trabajo por proyecto +- [Acciones de proyecto](/es/project-actions/) — guarda comandos que ejecutas a menudo +- [Contexto](/es/context/) — mira cuánta memoria del modelo usa una sesión diff --git a/packages/docs/content/docs/es/providers.mdx b/packages/docs/content/docs/es/providers.mdx new file mode 100644 index 00000000..e6df93d2 --- /dev/null +++ b/packages/docs/content/docs/es/providers.mdx @@ -0,0 +1,49 @@ +--- +title: Proveedores, modelos y agentes +description: Conecta proveedores de IA, elige modelos y configura agentes. +--- + +# Proveedores, modelos y agentes + +Antes de que OpenChamber pueda hacer algo, necesita al menos un proveedor de IA conectado. Esta página cubre cómo conectar un proveedor, elegir un modelo y ajustar los agentes. + +## Conecta un proveedor + +1. Abre **Settings → Providers**. +2. Abre el menú **Add provider** y elige un proveedor que aún no esté conectado. +3. Inicia sesión de una de estas dos formas, según el proveedor: + - **Clave de API** — pega tu clave y guarda. + - **Inicio de sesión (flujo de dispositivo)** — OpenChamber muestra un enlace y un código corto. Abre el enlace, introduce el código y aprueba. OpenChamber termina de conectarse por su cuenta. + +Cuando un proveedor aparece como conectado, sus modelos quedan disponibles en el chat. + +Para desconectar, abre el proveedor y elige eliminar su inicio de sesión. + +## Elige un modelo + +Eliges el modelo en el lugar donde trabajas: + +- en el chat, usa el selector de modelo de la barra de mensajes para fijar el proveedor y el modelo de esa sesión +- por agente, define un modelo predeterminado (más abajo) + +## Configura agentes + +Un agente es una configuración con nombre: un modelo, una personalidad y lo que se le permite hacer. + +1. Abre **Settings → Agents**. +2. Elige un agente o crea uno nuevo. +3. Edita cualquiera de estos campos: + - **description** — para qué sirve el agente + - **model** — su modelo predeterminado + - **temperature** — qué tan creativas son sus respuestas + - **prompt** — instrucciones permanentes que siempre sigue + - **tool rules** — qué herramientas puede usar + +## Dónde se guardan tus inicios de sesión + +Los inicios de sesión de los proveedores los guarda OpenCode, no OpenChamber, así que se comparten con la CLI de OpenCode. Si configuras el mismo proveedor en más de un lugar, gana el ajuste más específico: un ajuste por proyecto anula el personal. + +## Relacionado + +- [Servidores MCP](/es/mcp/) — añade herramientas extra para los agentes +- [Uso y cuotas](/es/usage/) — controla cuánto has consumido diff --git a/packages/docs/content/docs/es/remote-instances.mdx b/packages/docs/content/docs/es/remote-instances.mdx new file mode 100644 index 00000000..345415eb --- /dev/null +++ b/packages/docs/content/docs/es/remote-instances.mdx @@ -0,0 +1,30 @@ +--- +title: Instancias remotas +description: Conecta la app de escritorio a OpenChamber en otra máquina por SSH. +--- + +# Instancias remotas + +La app de escritorio puede conectarse a OpenChamber ejecutándose en otra máquina por SSH —un servidor de trabajo, una máquina en la nube, un homelab— y traer su UI a tu pantalla como si fuera local. Configúralo en **Settings → Remote Instances**. + +> Las instancias remotas son una función **solo de escritorio**. En la web o en VS Code, conéctate a un servidor remoto con las variables de entorno de [OpenCode Server](/es/opencode-server/) en su lugar. + +## Añade una instancia remota + +1. Abre **Settings → Remote Instances** y añade una. +2. Dale el comando SSH que usarías normalmente para alcanzar la máquina, más un apodo. +3. Elige cómo se ejecuta OpenChamber allí: + - **managed** — OpenChamber se instala y se inicia por sí mismo en la máquina remota + - **external** — conéctate a una que ya está en funcionamiento +4. Conecta. + +OpenChamber recorre los pasos —comprobar la conexión, configurar el remoto, iniciar el servidor y reenviar el puerto— y muestra en qué punto está en cada etapa. Cuando llega a **ready**, la UI remota se carga localmente. + +## Credenciales + +Tú decides si guardar las contraseñas de SSH y de UI o introducirlas cada vez. Si la conexión se cae, OpenChamber informa qué paso falló para que puedas arreglarlo; consulta [Acceso remoto](/es/troubleshooting/remote-access/). + +## Relacionado + +- [OpenCode Server](/es/opencode-server/) — conéctate a un servidor remoto en la web o en VS Code +- [Acceso remoto](/es/troubleshooting/remote-access/) — cuando una conexión no se completa diff --git a/packages/docs/content/docs/es/scheduled-tasks.mdx b/packages/docs/content/docs/es/scheduled-tasks.mdx new file mode 100644 index 00000000..b7fc2e4e --- /dev/null +++ b/packages/docs/content/docs/es/scheduled-tasks.mdx @@ -0,0 +1,33 @@ +--- +title: Tareas programadas +description: Ejecuta un prompt automáticamente según una programación. +--- + +# Tareas programadas + +Una tarea programada ejecuta un prompt por ti según una programación; por ejemplo, un "resume los cambios de ayer" diario o una limpieza semanal. Cuando se ejecuta, OpenChamber inicia una sesión nueva y envía el prompt por su cuenta. Abre el programador desde el botón en la parte superior de la barra lateral de sesiones. + +## Crea una tarea + +1. Abre el diálogo de tareas programadas desde la barra lateral de sesiones. +2. Añade una tarea y dale un nombre. +3. Elige cuándo se ejecuta: + - **diaria** — a una o varias horas cada día + - **semanal** — en los días de la semana y horas elegidos + - **una vez** — una sola fecha y hora +4. Define qué hace: el prompt a enviar, y el proveedor, modelo y agente a usar. El prompt puede ser un comando de barra, como `/review`. +5. Guarda y asegúrate de que la tarea esté habilitada. + +Puedes ejecutar cualquier tarea de inmediato con **run now** para comprobar que hace lo que esperas. + +## Cómo se ve el éxito + +Después de una ejecución, la tarea muestra cuándo se ejecutó por última vez, si tuvo éxito y un enlace a la sesión que creó. Si una ejecución falla, el error también se muestra ahí. + +## Ten en cuenta + +Las tareas solo se disparan mientras el servidor de OpenChamber está en funcionamiento. Si lo cierras, las ejecuciones programadas se pausan hasta que vuelva a estar activo. + +## Relacionado + +- [Comandos y fragmentos](/es/commands-snippets/) — reutiliza un comando de barra como prompt diff --git a/packages/docs/content/docs/es/security.mdx b/packages/docs/content/docs/es/security.mdx new file mode 100644 index 00000000..1830ce5f --- /dev/null +++ b/packages/docs/content/docs/es/security.mdx @@ -0,0 +1,37 @@ +--- +title: Seguridad +description: Protege la UI con una contraseña y passkeys antes de exponerla. +--- + +# Seguridad + +OpenChamber da acceso a tu máquina y a tu código, así que bloquéalo antes de que nadie más que tú pueda alcanzarlo. Esta página cubre la contraseña de UI, las passkeys y lo que debes saber antes de exponer OpenChamber a una red. + +## Define una contraseña de UI + +Inicia OpenChamber con una contraseña y la UI del navegador la pedirá: + +```bash +openchamber --ui-password be-creative-here +``` + +También puedes definirla con la variable de entorno `OPENCHAMBER_UI_PASSWORD` en lugar de ponerla en la línea de comandos. Tras iniciar sesión, OpenChamber recuerda el dispositivo durante un tiempo para no pedírtela cada vez. + +Define siempre una contraseña si la instancia es accesible para alguien más, especialmente a través de un [túnel](/es/tunnels/) o de internet público. + +## Passkeys + +Una vez definida una contraseña, puedes añadir passkeys (Face ID, Touch ID, una llave de seguridad) para un inicio de sesión más rápido. Añádelas en **Settings → OpenChamber → Passkeys**. + +Las passkeys están vinculadas a la contraseña actual. Si cambias o eliminas la contraseña, las passkeys guardadas se borran y tendrás que añadirlas de nuevo. + +## Antes de exponerlo + +- De forma predeterminada, OpenChamber solo escucha en tu propia máquina (`127.0.0.1`). Hace falta un cambio deliberado para escuchar más ampliamente, y deberías definir una contraseña primero. +- Prefiere un [túnel](/es/tunnels/) o una red privada (como una VPN) antes que abrir un puerto a internet. +- Si pones OpenChamber detrás de tu propio servidor HTTPS, consulta [Proxy inverso](/es/reverse-proxy/). + +## Relacionado + +- [Túneles](/es/tunnels/) — la forma recomendada de acceder a una instancia de forma remota +- [Proxy inverso](/es/reverse-proxy/) — ejecuta OpenChamber detrás de tu propio servidor diff --git a/packages/docs/content/docs/es/skills-catalog.mdx b/packages/docs/content/docs/es/skills-catalog.mdx new file mode 100644 index 00000000..801874c2 --- /dev/null +++ b/packages/docs/content/docs/es/skills-catalog.mdx @@ -0,0 +1,27 @@ +--- +title: Catálogo de skills +description: Explora e instala skills ya hechas. +--- + +# Catálogo de skills + +El catálogo de skills te permite instalar skills que otras personas han publicado en lugar de escribir las tuyas. Ábrelo en **Settings → Skills → Catalog**. + +Para escribir tus propias skills, consulta [Skills](/es/skills/). + +## Instala una skill + +1. Abre el catálogo. +2. Explora las fuentes integradas —el repositorio de skills de Anthropic y el registro comunitario de ClawdHub— o busca. +3. Elige una skill e instálala. +4. Elige dónde instalarla: para todo lo que hagas, o solo en el proyecto actual. + +Si ya existe una skill con el mismo nombre, OpenChamber pregunta qué hacer: omitirla, sobrescribirla o decidir skill por skill. + +## Añade tu propia fuente + +Puedes añadir cualquier repositorio de Git como fuente usando su nombre `owner/repo` o una URL de Git completa. Los repositorios privados necesitan tener el acceso configurado en tu máquina (una clave SSH o credenciales guardadas); si una fuente no puede autenticarse, el catálogo lo indica en lugar de fallar en silencio. + +## Relacionado + +- [Skills](/es/skills/) — crea y gestiona las skills instaladas diff --git a/packages/docs/content/docs/es/skills.mdx b/packages/docs/content/docs/es/skills.mdx new file mode 100644 index 00000000..54543d9e --- /dev/null +++ b/packages/docs/content/docs/es/skills.mdx @@ -0,0 +1,30 @@ +--- +title: Skills +description: Crea instrucciones reutilizables que los agentes cargan cuando las necesitan. +--- + +# Skills + +Una skill es un conjunto reutilizable de instrucciones que un agente puede incorporar cuando es relevante; por ejemplo, "cómo escribimos los mensajes de commit" o "nuestras convenciones de API". Las gestionas en **Settings → Skills**. + +Para instalar skills ya hechas en lugar de escribir las tuyas, consulta [Catálogo de skills](/es/skills-catalog/). + +## Crea una skill + +1. Abre **Settings → Skills**. +2. Crea una skill y dale un nombre y una descripción breve. La descripción es lo que el agente usa para decidir cuándo aplica la skill, así que hazla específica. +3. Escribe las instrucciones. Añade archivos de apoyo si la skill los necesita. +4. Elige dónde vive: + - **personal** — disponible en todos los proyectos + - **proyecto** — disponible solo en el proyecto actual + +## Usa una skill en el chat + +Escribe `/` en medio de un mensaje para abrir el selector de skills y elige una. El agente carga las instrucciones de esa skill para la respuesta. + +Una `/` al principio del mensaje abre los [comandos](/es/commands-snippets/) en su lugar. + +## Relacionado + +- [Catálogo de skills](/es/skills-catalog/) — instala skills que otros han publicado +- [Comandos y fragmentos](/es/commands-snippets/) — otras formas de reutilizar texto en el chat diff --git a/packages/docs/content/docs/es/troubleshooting/opencode-connection.mdx b/packages/docs/content/docs/es/troubleshooting/opencode-connection.mdx new file mode 100644 index 00000000..275db698 --- /dev/null +++ b/packages/docs/content/docs/es/troubleshooting/opencode-connection.mdx @@ -0,0 +1,34 @@ +--- +title: Conexión de OpenCode +description: Soluciona que OpenChamber no se conecte a su servidor de OpenCode. +--- + +# Conexión de OpenCode + +Si OpenChamber carga pero nunca pasa de "OpenCode is restarting", o el chat no responde, el servidor con el que se comunica no es accesible. Repasa estos pasos. + +## Se queda atascado en "OpenCode is restarting" + +- dale un momento justo después de iniciar: este estado es normal mientras el servidor arranca +- comprueba si el servidor está vivo con `openchamber status` +- reinícialo con `openchamber restart` +- ve los detalles de arranque con `openchamber logs` + +## Te conectas a tu propio servidor + +Si configuraste OpenChamber para usar un servidor existente, revisa de nuevo la configuración de [OpenCode Server](/es/opencode-server/): + +- `OPENCODE_HOST` debe incluir el puerto, sin ruta; por ejemplo `http://localhost:4096` +- define `OPENCODE_SKIP_START=true` para que OpenChamber no inicie también el suyo +- si la dirección es inválida, OpenChamber la ignora e inicia su propio servidor en su lugar; busca una advertencia `[config]` en los registros + +## Sigue fallando + +- confirma que Node.js sea la versión `20` o más reciente +- reinstala la última CLI +- abre `http://localhost:3000` directamente antes de probar cualquier túnel o enlace remoto + +## Relacionado + +- [OpenCode Server](/es/opencode-server/) — cómo encuentra y gestiona OpenChamber el servidor +- [Resolución de problemas](/es/troubleshooting/) — otros problemas comunes diff --git a/packages/docs/content/docs/es/troubleshooting/remote-access.mdx b/packages/docs/content/docs/es/troubleshooting/remote-access.mdx new file mode 100644 index 00000000..e587deb4 --- /dev/null +++ b/packages/docs/content/docs/es/troubleshooting/remote-access.mdx @@ -0,0 +1,38 @@ +--- +title: Acceso remoto +description: Soluciona túneles, instancias remotas y el acceso a OpenChamber desde otro dispositivo. +--- + +# Acceso remoto + +Cuando no puedes alcanzar OpenChamber desde tu teléfono u otra máquina, la solución depende de cómo te estés conectando. + +## Comprueba lo básico primero + +- abre `http://localhost:3000` en la misma computadora primero; si eso falla, no es un problema remoto; consulta [Conexión de OpenCode](/es/troubleshooting/opencode-connection/) +- confirma que el servidor está en funcionamiento con `openchamber status` + +## El enlace del túnel no funciona + +- ejecuta `openchamber tunnel status --all` +- reinicia el túnel desde la misma instancia y puerto +- regenera el enlace de conexión si el anterior ya se usó + +Consulta [Túneles](/es/tunnels/) para la configuración completa. + +## La instancia remota no se conecta (escritorio) + +Cuando una [instancia remota](/es/remote-instances/) se atasca, OpenChamber nombra el paso que falló: + +- **auth** — tu contraseña de SSH o de UI fue rechazada; vuelve a introducirla +- **install / start** — OpenChamber no pudo configurar o iniciar el servidor en la máquina remota; comprueba los requisitos de esa máquina +- **forwarding** — la conexión está activa pero el puerto no te llega; prueba un puerto local distinto + +## Detrás de tu propio servidor + +Si pones OpenChamber detrás de un proxy inverso y carga de forma extraña o no se conecta, consulta [Proxy inverso](/es/reverse-proxy/). + +## Relacionado + +- [Túneles](/es/tunnels/) · [Instancias remotas](/es/remote-instances/) · [Proxy inverso](/es/reverse-proxy/) +- [Seguridad](/es/security/) — protege la UI antes de exponerla diff --git a/packages/docs/content/docs/es/troubleshooting/worktrees-git.mdx b/packages/docs/content/docs/es/troubleshooting/worktrees-git.mdx new file mode 100644 index 00000000..761cfaed --- /dev/null +++ b/packages/docs/content/docs/es/troubleshooting/worktrees-git.mdx @@ -0,0 +1,35 @@ +--- +title: Worktrees y Git +description: Soluciona problemas comunes de worktrees y git. +--- + +# Worktrees y Git + +Problemas que surgen con las [sesiones de worktree](/es/worktrees/) y la [vista de git](/es/git/), y cómo resolverlos. + +## Un worktree requiere atención + +OpenChamber señala un worktree cuando algo no encaja: + +- **carpeta ausente** — la carpeta del worktree se eliminó o se movió fuera de OpenChamber; elimina la sesión y crea un worktree nuevo +- **rama desacoplada o sin nacer** — el worktree no está en una rama normal; haz checkout sobre una +- **fusión, rebase o cherry-pick en curso** — una operación quedó a medias; termínala o abórtala desde la vista de git + +## No se puede crear un worktree + +- **la rama ya existe** — elige un nombre de rama distinto, o usa la opción de rama existente +- **el nombre ya está en uso** — elige un nombre de worktree distinto + +## Falla la generación de commit o PR + +Generar un mensaje de commit o una descripción de PR se ejecuta en tu sesión activa, así que necesitas una sesión abierta con un modelo en funcionamiento seleccionado. Abre o elige una sesión e inténtalo de nuevo. + +## Problemas con SSH o rutas de Windows + +- asegúrate de que la clave SSH que usa el repo sea la que está configurada en tu [identidad de git](/es/git-identities/) +- en Windows, git usa rutas al estilo Unix (como `/c/Users/...`); OpenChamber lo gestiona, pero las rutas de claves SSH personalizadas deben seguir el mismo formato + +## Relacionado + +- [Sesiones de worktree](/es/worktrees/) — cómo se crean y eliminan los worktrees +- [Identidades de Git](/es/git-identities/) — define la clave e identidad correctas por repo diff --git a/packages/docs/content/docs/es/tunnels.mdx b/packages/docs/content/docs/es/tunnels.mdx index f329038a..0bed1cfd 100644 --- a/packages/docs/content/docs/es/tunnels.mdx +++ b/packages/docs/content/docs/es/tunnels.mdx @@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000 ## Relacionado +- [Seguridad](/es/security/) — protege la interfaz antes de exponerla +- [PWA y acceso móvil](/es/mobile/) — accede a OpenChamber desde tu teléfono - [Resolución de problemas](/es/troubleshooting/) — si el enlace del túnel no funciona diff --git a/packages/docs/content/docs/es/updates.mdx b/packages/docs/content/docs/es/updates.mdx new file mode 100644 index 00000000..fe1352d2 --- /dev/null +++ b/packages/docs/content/docs/es/updates.mdx @@ -0,0 +1,31 @@ +--- +title: Actualizaciones +description: Mantén OpenChamber actualizado en escritorio, web y VS Code. +--- + +# Actualizaciones + +Cómo actualizas OpenChamber depende de cómo lo instalaste. En todos los casos puedes comprobar tu versión actual en **Settings → OpenChamber → About**. + +## App de escritorio + +La app de escritorio busca actualizaciones contra las releases de GitHub. Cuando hay una disponible, OpenChamber te avisa, la descarga cuando lo eliges y la instala en el siguiente reinicio. Siempre tienes el control: nada se instala sin tu aprobación. + +## Web / CLI + +Si instalaste la CLI, actualízala desde **About** con los botones de comprobar y actualizar, o desde la terminal: + +```bash +openchamber update +``` + +OpenChamber detecta cómo se instaló (npm, pnpm, yarn o bun) y ejecuta la actualización correcta por ti. + +## El servidor de OpenCode + +OpenChamber y OpenCode se actualizan por separado. Cuando hay una nueva versión de OpenCode disponible, OpenChamber se ofrece a actualizarla y reinicia el servidor después. Consulta [OpenCode Server](/es/opencode-server/) para saber cómo se gestiona ese servidor. + +## Relacionado + +- [Instalación](/es/install/) — cómo se instala cada app en primer lugar +- [OpenCode Server](/es/opencode-server/) — actualizar el servidor subyacente diff --git a/packages/docs/content/docs/es/usage.mdx b/packages/docs/content/docs/es/usage.mdx new file mode 100644 index 00000000..8b935ad2 --- /dev/null +++ b/packages/docs/content/docs/es/usage.mdx @@ -0,0 +1,28 @@ +--- +title: Uso y cuotas +description: Controla cuánto de tu plan de proveedor has consumido. +--- + +# Uso y cuotas + +La página de uso muestra cuánto del plan de cada proveedor has consumido, para que veas qué tan cerca estás de un límite. Ábrela en **Settings → Usage**. + +## Lo que ves + +Para cada proveedor conectado, OpenChamber muestra: + +- cuánto de la ventana actual has usado, como una barra +- un desglose por modelo +- un indicador de ritmo, para saber si vas camino de agotarlo + +Puedes elegir qué proveedores aparecen, y el mismo resumen está disponible desde un menú desplegable en el encabezado de la app. + +## Proveedores compatibles + +El uso funciona con los proveedores que publican una cuota, entre ellos Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud y Wafer. + +Un proveedor solo muestra el uso una vez que has iniciado sesión en él en la página de [Proveedores](/es/providers/). Algunos proveedores necesitan un paso extra: por ejemplo, Ollama Cloud lee un archivo de sesión que configuras por separado. Si un proveedor no muestra datos, normalmente significa que falta esa credencial adicional. + +## Relacionado + +- [Proveedores, modelos y agentes](/es/providers/) — inicia sesión antes de que aparezca el uso diff --git a/packages/docs/content/docs/es/voice.mdx b/packages/docs/content/docs/es/voice.mdx new file mode 100644 index 00000000..102714f0 --- /dev/null +++ b/packages/docs/content/docs/es/voice.mdx @@ -0,0 +1,36 @@ +--- +title: Modo de voz +description: Habla con OpenChamber y escucha las respuestas leídas en voz alta. +--- + +# Modo de voz + +El modo de voz te permite dictar mensajes y que las respuestas se te lean en voz alta. Actívalo en **Settings → OpenChamber → Voice**. + +## Leer respuestas en voz alta (texto a voz) + +Elige cómo se pronuncian las respuestas: + +- **browser** — las voces integradas de tu navegador, sin configuración +- **OpenAI** — las voces de OpenAI; pega tu clave de API y elige una voz +- **compatible con OpenAI** — cualquier servicio que hable el formato de OpenAI; introduce su URL y, si la necesita, una clave de API +- **macOS say** — el comando `say` integrado, en los Mac que lo tienen + +Una vez activado, obtienes un botón de reproducción en los mensajes para escucharlos en voz alta. + +## Dictar mensajes (voz a texto) + +Elige cómo se transcribe tu voz: + +- **browser** — el reconocimiento integrado de tu navegador, sin configuración +- **server** — un servicio de transcripción compatible con OpenAI; introduce su URL y, si hace falta, una clave de API +- **on-device** — un modelo de voz que se ejecuta en tu navegador y se descarga la primera vez que lo usas + +## Una nota para teléfonos + +Para leer respuestas en voz alta en un teléfono, las opciones de OpenAI o compatible con OpenAI son las más fiables: los navegadores móviles limitan las voces integradas. + +## Relacionado + +- [Notificaciones](/es/notifications/) — recibe un aviso en lugar de escuchar +- [Proveedores, modelos y agentes](/es/providers/) — donde puede que ya tengas tu clave de OpenAI diff --git a/packages/docs/content/docs/es/worktrees.mdx b/packages/docs/content/docs/es/worktrees.mdx new file mode 100644 index 00000000..c4b0524d --- /dev/null +++ b/packages/docs/content/docs/es/worktrees.mdx @@ -0,0 +1,36 @@ +--- +title: Sesiones de worktree +description: Da a una sesión su propia rama y carpeta para que el trabajo quede aislado. +--- + +# Sesiones de worktree + +Una sesión de worktree se ejecuta en su propia copia del repositorio, en su propia rama (un worktree de git). Eso evita que las sesiones paralelas se pisen los archivos: una puede refactorizar mientras otra corrige un error, sin estar cambiando de un lado a otro. + +## Crea una + +1. Abre el diálogo de nuevo worktree desde el botón en la parte superior de la barra lateral de sesiones. +2. Elige un punto de partida: + - **nueva rama** — nombra la rama y elige desde qué rama partir + - **rama existente** — haz checkout de una rama que ya tengas +3. Confirma la carpeta del worktree (OpenChamber sugiere una a partir del nombre de la rama). +4. Créala. + +OpenChamber crea la rama, configura la carpeta e inicia una sesión en ella. También puedes arrancar una directamente desde una [tarea](/es/notes-todos-plans/) o desde una [issue o PR de GitHub](/es/github/). + +## Trae el trabajo de vuelta + +Cuando el trabajo esté listo, usa **Integrate** en la vista de Git para traer los commits del worktree a otra rama (como `main`). Si un cambio entra en conflicto, puedes entregarle el conflicto al agente para que lo resuelva. + +## Limpieza + +Eliminar o archivar la sesión puede quitar el worktree. Tú eliges si también eliminar la rama: local, y remota si la hay. No se elimina nada sin que lo pidas. + +## Si algo no encaja + +Un worktree puede requerir atención si su carpeta desapareció, su rama está en un estado desacoplado, o una fusión o rebase quedó a medias. OpenChamber lo señala para que lo arregles; consulta [Worktrees y Git](/es/troubleshooting/worktrees-git/). + +## Relacionado + +- [Multi-run](/es/multi-run/) — lanza muchas sesiones de worktree a la vez +- [Flujos de trabajo de Git y GitHub](/es/git/) — haz commit e integra desde dentro de OpenChamber diff --git a/packages/docs/content/docs/git-identities.mdx b/packages/docs/content/docs/git-identities.mdx new file mode 100644 index 00000000..bf6e6b4b --- /dev/null +++ b/packages/docs/content/docs/git-identities.mdx @@ -0,0 +1,30 @@ +--- +title: Git Identities +description: Commit as the right name and email for each repository. +--- + +# Git Identities + +A git identity is the name and email your commits are signed with. If you work across personal and work repos, you can save identities and apply the right one per repository, instead of relying on a single global setting. Manage them at **Settings → Git**. + +## Add an identity + +1. Open **Settings → Git** and choose **New**. +2. Enter the **name** and **email** to commit with. +3. Pick how it authenticates with the remote: + - **SSH** — point it at an SSH key + - **token** — use a saved credential for a host +4. Optionally give it a color and icon so it's easy to spot. + +Your system's global identity is shown too, as read-only. + +## Apply an identity to a repo + +Applying an identity writes it to that repository's **local** git config — it only affects that repo, not your global setting. SSH identities also set the SSH command to use your key; token identities set up credential storage for the host. + +You can import identities OpenChamber discovers from your existing git credentials and save them as token identities. + +## Related + +- [Git & GitHub Workflows](/git/) — commit using the identity you set +- [GitHub Issues & PRs](/github/) — connect a GitHub account for PRs diff --git a/packages/docs/content/docs/git.mdx b/packages/docs/content/docs/git.mdx new file mode 100644 index 00000000..62eb7352 --- /dev/null +++ b/packages/docs/content/docs/git.mdx @@ -0,0 +1,41 @@ +--- +title: Git & GitHub Workflows +description: Stage, commit, and manage branches without leaving OpenChamber. +--- + +# Git & GitHub Workflows + +OpenChamber has a built-in git view so you can review changes, commit, and manage branches without switching to a terminal. Open it from the **Git** tab in the right sidebar. + +## Review and commit + +The git view splits your changes into **staged** and **unstaged**: + +- click a file's **+** to stage it, or **−** to unstage it +- stage or unstage everything in a group at once +- click a file to see its diff + +Then write a commit message and commit. You can have OpenChamber **generate a commit message** from your staged changes — it uses the current session's model, so you need a session open. + +## Branches and history + +The git view also covers the everyday rest of git: + +- create, switch, rename, and delete branches +- push, pull, and fetch +- browse history and per-commit diffs +- stash and restore changes + +## Pull requests + +Connect GitHub (see [GitHub Issues & PRs](/github/)) and the **PR** tab lets you open a pull request, update it, mark it ready, or merge it — and generate its title and description the same way as commit messages. + +## Bringing in conflicts + +If a merge, rebase, or integrate hits a conflict, OpenChamber shows what's stuck and lets you resolve it — including handing it to the agent. + +## Related + +- [GitHub Issues & PRs](/github/) — connect GitHub and start work from issues +- [Worktree Sessions](/worktrees/) — isolate a branch in its own folder +- [Git Identities](/git-identities/) — commit as the right person per repo diff --git a/packages/docs/content/docs/github.mdx b/packages/docs/content/docs/github.mdx new file mode 100644 index 00000000..95555ad5 --- /dev/null +++ b/packages/docs/content/docs/github.mdx @@ -0,0 +1,34 @@ +--- +title: GitHub Issues & PRs +description: Connect GitHub and start sessions from issues and pull requests. +--- + +# GitHub Issues & PRs + +Connect your GitHub account and OpenChamber can pull in issues and pull requests, start a session straight from one, and open or update PRs for you. + +## Connect GitHub + +1. Open **Settings → Git**. +2. Under GitHub, choose **Connect**. OpenChamber shows a link and a short code. +3. Open the link, enter the code, and approve. + +When it's connected, your account shows under the GitHub section. You can connect more than one account and switch between them, or disconnect at any time. + +## Start work from an issue or PR + +When you create a [worktree session](/worktrees/) with GitHub connected, you can choose **Start from GitHub issue/PR**: + +- pick an **issue** and OpenChamber names the branch after it and opens the session with the issue and its comments as the first message +- pick a **pull request** and it checks out the PR's branch; you can include the PR's diff so the agent has the full change + +This drops you straight into a session with the context already loaded. + +## Open and manage pull requests + +From the **PR** tab in the [git view](/git/), you can create a pull request, update it, mark a draft as ready, or merge it. OpenChamber can generate the PR title and description from your changes. + +## Related + +- [Git & GitHub Workflows](/git/) — commit and manage branches +- [Worktree Sessions](/worktrees/) — where issue and PR sessions start diff --git a/packages/docs/content/docs/index.mdx b/packages/docs/content/docs/index.mdx index 7acb6b67..292f4b59 100644 --- a/packages/docs/content/docs/index.mdx +++ b/packages/docs/content/docs/index.mdx @@ -20,6 +20,13 @@ Use these docs to: - [Tunnels](/tunnels/) - [Troubleshooting](/troubleshooting/) +## Explore + +- [Projects](/projects/) and [Worktree Sessions](/worktrees/) — organize and isolate your work +- [Providers, Models & Agents](/providers/) — connect OpenCode and pick a model +- [Git & GitHub Workflows](/git/) — commit, review, and open PRs +- [Security](/security/) and [Tunnels](/tunnels/) — protect and reach your instance + ## What OpenChamber is for OpenChamber is for the parts of AI coding that benefit from a control room: branching sessions, reviewing diffs, managing terminals, watching tool progress, running project actions, and keeping the full board visible while the agent works. diff --git a/packages/docs/content/docs/ko/commands-snippets.mdx b/packages/docs/content/docs/ko/commands-snippets.mdx new file mode 100644 index 00000000..31e31994 --- /dev/null +++ b/packages/docs/content/docs/ko/commands-snippets.mdx @@ -0,0 +1,39 @@ +--- +title: 명령 및 스니펫 +description: 채팅에서 재사용할 수 있는 슬래시 명령과 텍스트 스니펫을 만드세요. +--- + +# 명령 및 스니펫 + +명령과 스니펫은 모두 같은 내용을 다시 입력하는 수고를 덜어줍니다. 명령은 `/`로 실행하는 전체 프롬프트이고, 스니펫은 `#`로 메시지에 넣는 짧은 텍스트 조각입니다. + +## Commands + +명령은 `/review`처럼 슬래시로 실행하는 저장된 프롬프트입니다. **Settings → Commands**에서 관리합니다. + +1. **Settings → Commands**를 열고 명령을 만듭니다. +2. 이름, 설명, 보낼 프롬프트 텍스트를 지정합니다. +3. 필요하다면 특정 에이전트나 모델에 고정합니다. +4. personal 또는 project 범위를 선택합니다. + +채팅에서 메시지의 **첫** 글자로 `/`를 입력하면 명령이 나타나며, 그중 하나를 선택합니다. 텍스트에는 플레이스홀더를 사용할 수 있습니다. + +- `$ARGUMENTS` — 명령 뒤에 입력한 내용 +- `@filename` — 파일의 내용을 삽입 +- `` !`command` `` — 셸 명령의 출력을 삽입 + +내장된 `init`과 `review` 명령은 초기화할 수 있지만 삭제할 수는 없습니다. + +## Snippets + +스니펫은 `#signoff`처럼 해시태그로 인라인에서 참조하는 재사용 가능한 텍스트입니다. **Settings → Snippets**에서 관리합니다. + +1. **Settings → Snippets**를 열고 스니펫을 만듭니다. +2. 이름과 대체할 텍스트를 지정합니다. 트리거를 여러 개 두려면 별칭을 추가합니다. +3. personal 또는 project 범위를 선택합니다. + +채팅에서 `#`를 입력하고 스니펫을 선택합니다. OpenChamber가 보내기 전에 전체 텍스트로 바꿔 넣습니다. + +## 관련 항목 + +- [Skills](/ko/skills/) — 더 큰 지침 모음을 필요할 때 불러오세요 diff --git a/packages/docs/content/docs/ko/context.mdx b/packages/docs/content/docs/ko/context.mdx new file mode 100644 index 00000000..4949f662 --- /dev/null +++ b/packages/docs/content/docs/ko/context.mdx @@ -0,0 +1,38 @@ +--- +title: 컨텍스트 +description: 세션이 모델의 메모리를 얼마나 사용하는지 확인하세요. +--- + +# 컨텍스트 + +모든 모델은 한 번에 대화의 일정량만 담을 수 있습니다. 이것이 컨텍스트입니다. OpenChamber는 컨텍스트가 얼마나 찼는지 보여주므로, 세션이 한도에 가까워져 응답이 오래된 세부 내용을 버리기 시작할 시점을 알 수 있습니다. + +## 빠른 표시기 + +채팅하는 동안 작은 게이지가 사용한 컨텍스트의 비율을 표시합니다. 채워질수록 색이 바뀝니다. + +- 초록색 — 여유 충분 +- 노란색 — 차고 있음(약 4분의 3) +- 빨간색 — 거의 가득 참 + +게이지에 마우스를 올리면(모바일에서는 탭하면) 정확한 토큰 수를 볼 수 있습니다. + +## 전체 컨텍스트 패널 + +현재 세션을 더 자세히 보려면 오른쪽 사이드바의 **Context** 탭을 엽니다. + +- 사용 중인 모델과 세션 시작 시점 +- 모델 한도 대비 총 토큰 수 +- 메시지 및 비용 합계 +- 마지막 응답의 토큰 분석 +- 무엇이 컨텍스트를 차지하는지에 대한 대략적인 구분(사용자 메시지, 에이전트 메시지, 도구 출력) + +이 구분은 정확한 수치가 아니라 추정치입니다. 청구가 아니라 무엇이 창을 채우는지 파악하는 데 사용하세요. + +## 가득 찼을 때 할 일 + +하나의 세션을 끝없이 키우지 말고 새 작업에는 새 세션을 시작하세요. 짧은 컨텍스트가 더 빠르고 모델을 집중시킵니다. + +## 관련 항목 + +- [Projects](/ko/projects/) — 세션은 프로젝트별로 그룹화됩니다 diff --git a/packages/docs/content/docs/ko/desktop-browser.mdx b/packages/docs/content/docs/ko/desktop-browser.mdx new file mode 100644 index 00000000..ed0d58f0 --- /dev/null +++ b/packages/docs/content/docs/ko/desktop-browser.mdx @@ -0,0 +1,22 @@ +--- +title: 데스크톱 브라우저 +description: 검사 및 콘솔 캡처 기능과 함께 데스크톱 앱 안에서 임의의 페이지를 탐색하세요. +--- + +# 데스크톱 브라우저 + +데스크톱 앱에는 내장 브라우저가 있어 채팅 바로 옆에서 임의의 페이지를 열고, 요소를 가리켜 질문하고, 페이지의 콘솔을 캡처할 수 있습니다. 앱 헤더의 지구본 버튼에서 엽니다. + +> 데스크톱 브라우저는 **데스크톱 전용** 기능입니다. 웹에서는 [미리보기](/ko/preview/) 패널이 로컬 개발 서버에 대해 동일한 검사 및 콘솔 도구를 제공합니다. + +## 검사 및 주석 + +**inspect**를 켜고 페이지의 임의 요소를 클릭합니다. OpenChamber가 그것이 무엇인지, 스타일, 위치, 스크린샷을 담은 메모를 캡처해 채팅 메시지에 첨부합니다. 에이전트에게 "바로 여기 이 요소"라고 알리는 가장 빠른 방법입니다. + +## 콘솔 캡처 + +브라우저는 페이지의 콘솔 출력(오류, 경고, 로그)을 수집하므로 개발자 도구를 열지 않고도 필터링하여 읽을 수 있습니다. + +## 관련 항목 + +- [Preview & Dev Servers](/ko/preview/) — 로컬 개발 서버에 대한 동일한 도구 diff --git a/packages/docs/content/docs/ko/git-identities.mdx b/packages/docs/content/docs/ko/git-identities.mdx new file mode 100644 index 00000000..56794485 --- /dev/null +++ b/packages/docs/content/docs/ko/git-identities.mdx @@ -0,0 +1,30 @@ +--- +title: Git 아이덴티티 +description: 저장소마다 올바른 이름과 이메일로 커밋하세요. +--- + +# Git 아이덴티티 + +git 신원은 커밋에 서명되는 이름과 이메일입니다. 개인 저장소와 업무 저장소를 오가며 작업한다면, 하나의 전역 설정에 의존하는 대신 신원을 저장해 두고 저장소마다 알맞은 것을 적용할 수 있습니다. **Settings → Git**에서 관리합니다. + +## 신원 추가하기 + +1. **Settings → Git**를 열고 **New**를 선택합니다. +2. 커밋에 사용할 **name**과 **email**을 입력합니다. +3. 원격과 인증하는 방식을 선택합니다. + - **SSH** — SSH 키를 지정합니다 + - **token** — 호스트에 저장된 자격 증명을 사용합니다 +4. 필요하다면 알아보기 쉽도록 색상과 아이콘을 지정합니다. + +시스템의 전역 신원도 읽기 전용으로 표시됩니다. + +## 저장소에 신원 적용하기 + +신원을 적용하면 해당 저장소의 **local** git 설정에 기록됩니다. 전역 설정이 아니라 그 저장소에만 영향을 줍니다. SSH 신원은 사용자의 키를 사용하도록 SSH 명령도 설정하고, token 신원은 호스트용 자격 증명 저장소를 설정합니다. + +OpenChamber가 기존 git 자격 증명에서 찾아낸 신원을 가져와 token 신원으로 저장할 수 있습니다. + +## 관련 항목 + +- [Git & GitHub Workflows](/ko/git/) — 설정한 신원으로 커밋하세요 +- [GitHub Issues & PRs](/ko/github/) — PR을 위해 GitHub 계정을 연결하세요 diff --git a/packages/docs/content/docs/ko/git.mdx b/packages/docs/content/docs/ko/git.mdx new file mode 100644 index 00000000..5ff97b33 --- /dev/null +++ b/packages/docs/content/docs/ko/git.mdx @@ -0,0 +1,41 @@ +--- +title: Git 및 GitHub 워크플로 +description: OpenChamber를 벗어나지 않고 스테이징, 커밋, 브랜치 관리를 하세요. +--- + +# Git 및 GitHub 워크플로 + +OpenChamber에는 내장 git 보기가 있어 터미널로 전환하지 않고도 변경 사항을 검토하고, 커밋하고, 브랜치를 관리할 수 있습니다. 오른쪽 사이드바의 **Git** 탭에서 엽니다. + +## 검토 및 커밋 + +git 보기는 변경 사항을 **staged**와 **unstaged**로 나눕니다. + +- 파일의 **+**를 클릭해 스테이징하거나 **−**를 클릭해 스테이징을 해제합니다 +- 그룹의 모든 항목을 한 번에 스테이징하거나 해제합니다 +- 파일을 클릭해 diff를 봅니다 + +그런 다음 커밋 메시지를 작성하고 커밋합니다. OpenChamber가 스테이징된 변경 사항에서 **커밋 메시지를 생성**하게 할 수 있습니다. 현재 세션의 모델을 사용하므로 세션이 열려 있어야 합니다. + +## 브랜치와 히스토리 + +git 보기는 일상적인 나머지 git 작업도 다룹니다. + +- 브랜치 생성, 전환, 이름 변경, 삭제 +- push, pull, fetch +- 히스토리와 커밋별 diff 탐색 +- 변경 사항 stash 및 복원 + +## 풀 리퀘스트 + +GitHub를 연결하면([GitHub Issues & PRs](/ko/github/) 참고) **PR** 탭에서 풀 리퀘스트를 열고, 업데이트하고, 준비 완료로 표시하거나 병합할 수 있습니다. 그리고 커밋 메시지와 같은 방식으로 제목과 설명을 생성할 수 있습니다. + +## 충돌 가져오기 + +병합, 리베이스, 통합이 충돌하면 OpenChamber가 무엇이 막혔는지 보여주고 해결하게 해줍니다. 에이전트에게 넘기는 것도 포함됩니다. + +## 관련 항목 + +- [GitHub Issues & PRs](/ko/github/) — GitHub를 연결하고 이슈에서 작업을 시작하세요 +- [Worktree Sessions](/ko/worktrees/) — 브랜치를 자체 폴더에 격리하세요 +- [Git Identities](/ko/git-identities/) — 저장소마다 올바른 사람으로 커밋하세요 diff --git a/packages/docs/content/docs/ko/github.mdx b/packages/docs/content/docs/ko/github.mdx new file mode 100644 index 00000000..5e61b22b --- /dev/null +++ b/packages/docs/content/docs/ko/github.mdx @@ -0,0 +1,34 @@ +--- +title: GitHub 이슈 및 PR +description: GitHub를 연결하고 이슈와 풀 리퀘스트에서 세션을 시작하세요. +--- + +# GitHub 이슈 및 PR + +GitHub 계정을 연결하면 OpenChamber가 이슈와 풀 리퀘스트를 가져오고, 그중 하나에서 바로 세션을 시작하고, PR을 열거나 업데이트할 수 있습니다. + +## GitHub 연결하기 + +1. **Settings → Git**를 엽니다. +2. GitHub 아래에서 **Connect**를 선택합니다. OpenChamber가 링크와 짧은 코드를 표시합니다. +3. 링크를 열고 코드를 입력한 뒤 승인합니다. + +연결되면 GitHub 섹션 아래에 계정이 표시됩니다. 계정을 여러 개 연결해 전환할 수 있으며, 언제든 연결을 해제할 수 있습니다. + +## 이슈나 PR에서 작업 시작하기 + +GitHub가 연결된 상태에서 [worktree 세션](/ko/worktrees/)을 만들면 **Start from GitHub issue/PR**을 선택할 수 있습니다. + +- **issue**를 선택하면 OpenChamber가 그 이슈에 따라 브랜치 이름을 짓고, 이슈와 그 댓글을 첫 메시지로 하여 세션을 엽니다 +- **pull request**를 선택하면 PR의 브랜치를 체크아웃합니다. PR의 diff를 포함하면 에이전트가 전체 변경 사항을 갖게 됩니다 + +이렇게 하면 컨텍스트가 이미 로드된 세션으로 바로 들어갑니다. + +## 풀 리퀘스트 열기 및 관리 + +[git 보기](/ko/git/)의 **PR** 탭에서 풀 리퀘스트를 만들고, 업데이트하고, 초안을 준비 완료로 표시하거나 병합할 수 있습니다. OpenChamber는 변경 사항에서 PR 제목과 설명을 생성할 수 있습니다. + +## 관련 항목 + +- [Git & GitHub Workflows](/ko/git/) — 커밋하고 브랜치를 관리하세요 +- [Worktree Sessions](/ko/worktrees/) — 이슈 및 PR 세션이 시작되는 곳 diff --git a/packages/docs/content/docs/ko/index.mdx b/packages/docs/content/docs/ko/index.mdx index da2db722..a46d8dff 100644 --- a/packages/docs/content/docs/ko/index.mdx +++ b/packages/docs/content/docs/ko/index.mdx @@ -20,6 +20,13 @@ OpenChamber는 OpenCode(터미널에서 실행되는 AI 코딩 에이전트)를 - [터널](/ko/tunnels/) - [문제 해결](/ko/troubleshooting/) +## 더 둘러보기 + +- [프로젝트](/ko/projects/)와 [Worktree 세션](/ko/worktrees/) — 작업을 정리하고 격리하세요 +- [공급자, 모델, 에이전트](/ko/providers/) — OpenCode를 연결하고 모델을 선택하세요 +- [Git 및 GitHub 워크플로](/ko/git/) — 커밋하고 검토하고 PR을 여세요 +- [보안](/ko/security/)과 [터널](/ko/tunnels/) — 인스턴스를 보호하고 접속하세요 + ## OpenChamber는 무엇을 위한 것인가 OpenChamber는 관제 센터가 도움이 되는 AI 코딩 작업을 위한 것입니다. 세션 분기, diff 검토, 터미널 관리, 도구 진행 상황 관찰, 프로젝트 액션 실행, 그리고 에이전트가 작업하는 동안 전체 보드를 한눈에 유지하는 일입니다. diff --git a/packages/docs/content/docs/ko/magic-prompts.mdx b/packages/docs/content/docs/ko/magic-prompts.mdx new file mode 100644 index 00000000..e826e7b9 --- /dev/null +++ b/packages/docs/content/docs/ko/magic-prompts.mdx @@ -0,0 +1,26 @@ +--- +title: 매직 프롬프트 +description: OpenChamber의 자동화 흐름 뒤에 있는 내장 프롬프트를 맞춤 설정하세요. +--- + +# 매직 프롬프트 + +OpenChamber는 커밋 메시지 작성, PR 초안 작성, 이슈 검토, 충돌 해결, 세션 요약 같은 작업을 자동으로 할 때마다 뒤에서 내장 프롬프트를 사용합니다. Magic Prompts는 그러한 프롬프트를 읽고 다시 쓰는 곳입니다. **Settings → Magic Prompts**에서 엽니다. + +일반적인 사용에는 이 페이지가 필요하지 않습니다. 흐름이 다르게 동작하기를 원할 때, 예를 들어 특정 스타일의 커밋 메시지를 원할 때 사용하세요. + +## 프롬프트 편집하기 + +1. **Settings → Magic Prompts**를 엽니다. +2. 사이드바의 그룹(Git, GitHub, Planning, Session)에서 프롬프트를 선택합니다. +3. 텍스트를 편집하고 저장합니다. + +일부 프롬프트에는 보이는 부분(사용자에게 표시되는 메시지)과 지침 부분(에이전트를 위한 숨겨진 안내)이 있습니다. 프롬프트에는 diff나 이슈 제목처럼 OpenChamber가 채워 넣는 `{{placeholders}}`가 포함될 수 있으니 그대로 두세요. + +## 초기화 + +마음이 바뀌었나요? 각 프롬프트에는 **reset to default**가 있고, 모든 곳에서 처음부터 다시 시작하려면 **reset all**이 있습니다. + +## 관련 항목 + +- [Git & GitHub Workflows](/ko/git/) — 이러한 프롬프트 중 다수가 git 흐름을 구동합니다 diff --git a/packages/docs/content/docs/ko/mcp.mdx b/packages/docs/content/docs/ko/mcp.mdx new file mode 100644 index 00000000..fea97022 --- /dev/null +++ b/packages/docs/content/docs/ko/mcp.mdx @@ -0,0 +1,30 @@ +--- +title: MCP 서버 +description: MCP 서버를 추가하여 에이전트에 추가 도구를 제공하세요. +--- + +# MCP 서버 + +MCP 서버는 에이전트에 데이터베이스 검색, API 호출, 사용하는 서비스 읽기 같은 추가 도구를 제공합니다. **Settings → MCP**에서 추가합니다. + +## 서버 추가하기 + +1. **Settings → MCP**를 엽니다. +2. 서버를 추가하고 유형을 선택합니다. + - **local** — OpenChamber가 사용자의 컴퓨터에서 명령을 실행합니다. 실행할 명령과, 필요하다면 환경 변수를 제공합니다. + - **remote** — OpenChamber가 다른 누군가가 호스팅하는 URL에 연결합니다. URL과 필요한 헤더(예: 인증 토큰)를 제공합니다. +3. 저장합니다. 서버는 기본적으로 켜져 있으며, 삭제하지 않고도 끌 수 있습니다. + +## 적용 범위 + +서버를 추가할 때 범위를 선택합니다. + +- **personal** — 모든 프로젝트에서 사용 가능 +- **project** — 현재 프로젝트에서만 사용 가능하며, 프로젝트의 다른 설정과 함께 저장됨 + +서버 이름에는 소문자, 숫자, 하이픈, 밑줄을 사용합니다. + +## 관련 항목 + +- [Providers, Models & Agents](/ko/providers/) — 먼저 모델을 연결하세요 +- [Skills](/ko/skills/) — 에이전트의 기능을 확장하는 또 다른 방법 diff --git a/packages/docs/content/docs/ko/mobile.mdx b/packages/docs/content/docs/ko/mobile.mdx new file mode 100644 index 00000000..04793b5a --- /dev/null +++ b/packages/docs/content/docs/ko/mobile.mdx @@ -0,0 +1,31 @@ +--- +title: PWA 및 모바일 접속 +description: OpenChamber를 앱으로 설치하고 휴대폰에서 사용하세요. +--- + +# PWA 및 모바일 접속 + +OpenChamber 웹 앱은 휴대폰 앱(PWA)처럼 설치되므로 홈 화면에 두고 전체 화면으로 사용할 수 있습니다. [터널](/ko/tunnels/)과 함께 사용하면 어디서든 세션을 확인할 수 있습니다. + +## 설치하기 + +OpenChamber는 브라우저의 내장 설치 기능을 사용하므로 별도의 다운로드가 없습니다. + +- **데스크톱 브라우저** — 주소 표시줄의 **Install** 옵션을 사용합니다 +- **iPhone/iPad (Safari)** — 공유 → **홈 화면에 추가** +- **Android (Chrome)** — 메뉴 → **앱 설치** / **홈 화면에 추가** + +설치되면 브라우저 크롬 없이 자체 창에서 열립니다. + +## 휴대폰에서 접근하기 + +서버가 사용자의 컴퓨터에서 실행될 때 휴대폰에서 OpenChamber를 열려면 [터널](/ko/tunnels/)을 시작하고 휴대폰에서 링크를 열거나 QR 코드를 스캔합니다. 이렇게 할 때는 항상 강력한 [UI 비밀번호](/ko/security/)를 사용하세요. + +## 모바일 설정 + +**Settings → OpenChamber** 아래의 몇 가지 옵션은 모바일 및 설치된 경험을 조정합니다. 앱의 설치 이름, 화면 방향, 화면 키보드의 동작 방식이 해당됩니다. + +## 관련 항목 + +- [Tunnels](/ko/tunnels/) — 다른 네트워크에서 인스턴스에 접근하세요 +- [Security](/ko/security/) — 노출하기 전에 UI를 보호하세요 diff --git a/packages/docs/content/docs/ko/multi-run.mdx b/packages/docs/content/docs/ko/multi-run.mdx new file mode 100644 index 00000000..cca3e510 --- /dev/null +++ b/packages/docs/content/docs/ko/multi-run.mdx @@ -0,0 +1,34 @@ +--- +title: Multi-run +description: 동일한 프롬프트를 여러 모델이나 세션에서 한 번에 실행하세요. +--- + +# Multi-run + +Multi-run은 하나의 양식에서 여러 세션을 시작합니다. 같은 작업을 다른 모델로 시도하고 결과를 비교하는 데 유용합니다. 세션 사이드바 상단의 버튼에서 엽니다. + +## Multi-run 시작하기 + +1. multi-run 런처를 엽니다. +2. 프로젝트를 선택하고 실행 그룹의 이름을 지정합니다. +3. 프롬프트를 작성하고 실행할 모델을 선택합니다(그룹당 최대 다섯 개). +4. **isolate runs** 여부를 선택합니다. +5. 시작합니다. + +각 모델은 자체 세션을 가지며, 모두 사용자의 프롬프트로 시작합니다. + +## 격리된 실행 + +**isolate runs**를 켜면 모든 실행에 자체 [worktree](/ko/worktrees/)와 브랜치가 부여되어 같은 파일을 절대 건드리지 않습니다. 이를 위해서는 git 저장소가 필요하며, 저장소가 아닌 폴더에서는 자동으로 꺼집니다. 실행이 시작될 브랜치를 선택하세요. + +격리를 끄면 모든 실행은 프로젝트 폴더 안의 평범한 세션입니다. + +## 결과 비교하기 + +각 실행은 열고, 읽고, 유지하거나 버릴 수 있는 일반 세션입니다. 접근 방식을 비교하려고 실행을 시작했다면 나란히 검토하고 가장 좋은 것을 이어가세요. + +단일 실행이 시작에 실패해도 나머지는 계속 시작됩니다. 요청한 것보다 세션이 적게 보일 뿐입니다. + +## 관련 항목 + +- [Worktree Sessions](/ko/worktrees/) — 격리가 내부적으로 작동하는 방식 diff --git a/packages/docs/content/docs/ko/notes-todos-plans.mdx b/packages/docs/content/docs/ko/notes-todos-plans.mdx new file mode 100644 index 00000000..d5af533a --- /dev/null +++ b/packages/docs/content/docs/ko/notes-todos-plans.mdx @@ -0,0 +1,37 @@ +--- +title: 프로젝트 메모, 할 일, 계획 +description: 프로젝트마다 노트, 할 일 목록, 저장된 계획을 유지하세요. +--- + +# 프로젝트 메모, 할 일, 계획 + +각 프로젝트에는 노트, 할 일 목록, 저장된 계획을 위한 자체 작업 공간이 있습니다. 이들은 특정 세션이 아니라 프로젝트에 속하므로 세션 사이를 오가도 그대로 유지됩니다. 오른쪽 사이드바의 **Context** 탭(모바일에서는 전용 탭)에서 찾을 수 있습니다. + +## Notes + +프로젝트에 대해 기억하고 싶은 것을 자유롭게 적는 노트 상자입니다. 입력하는 동안 자동으로 저장됩니다. + +## Todos + +간단한 체크리스트입니다. 항목을 추가하고, 체크하고, 드래그로 순서를 바꾸고, 완료된 항목을 정리합니다. + +각 할 일에는 에이전트에게 넘길 수 있는 **send** 메뉴가 있습니다. + +- 현재 세션으로 보내기 +- 그것으로 새 세션 시작 +- 그것으로 새 [worktree 세션](/ko/worktrees/) 시작(프로젝트가 git 저장소일 때만 가능) + +## Plans + +더 긴 계획을 저장된 파일로 보관하는 공간입니다. 다음을 할 수 있습니다. + +- Markdown 또는 텍스트 파일에서 계획 가져오기 +- 계획을 열어 사이드 패널에서 읽기 +- 더 이상 필요 없는 계획 삭제 + +노트가 저장되거나, 할 일이 체크되거나, 계획이 목록에 표시된 상태로 Context 탭에 돌아와야 합니다. 그것으로 반영되었음을 알 수 있습니다. + +## 관련 항목 + +- [Worktree Sessions](/ko/worktrees/) — 할 일을 자체 브랜치에서 실행하세요 +- [Projects](/ko/projects/) — 이들은 활성 프로젝트에 속합니다 diff --git a/packages/docs/content/docs/ko/notifications.mdx b/packages/docs/content/docs/ko/notifications.mdx new file mode 100644 index 00000000..5ac9e266 --- /dev/null +++ b/packages/docs/content/docs/ko/notifications.mdx @@ -0,0 +1,34 @@ +--- +title: 알림 +description: 세션이 사용자를 필요로 하거나 완료될 때 알림을 받으세요. +--- + +# 알림 + +알림은 화면을 지켜보지 않아도 무언가가 사용자의 주의를 필요로 할 때, 즉 세션이 완료되었거나, 오류가 발생했거나, 질문했거나, 무언가를 할 권한이 필요할 때 알려줍니다. **Settings → OpenChamber → Notifications**에서 설정합니다. + +## 켜기 + +1. **Settings → OpenChamber → Notifications**를 엽니다. +2. 브라우저나 시스템이 요청하면 알림을 허용합니다. +3. 알림받고 싶은 내용을 선택합니다. + - 세션 **완료** + - 세션 **오류** 발생 + - 세션이 **질문**할 때 + - 세션이 **권한**을 필요로 할 때 + - **하위 작업** 완료 + +## 전달 방식 + +- **데스크톱**에서는 네이티브 시스템 알림을 받습니다 +- **브라우저 또는 설치된 앱**에서는 웹 푸시 알림을 받으므로 탭이 백그라운드에 있어도 도착합니다 + +자동 수락으로 설정된 세션은 권한 알림으로 귀찮게 하지 않습니다. + +## 문구 맞춤 설정 + +각 알림 종류에는 에이전트 이름과 모델 같은 필드를 사용해 편집할 수 있는 제목과 메시지 템플릿이 있습니다. 또한 알림이 짧게 유지되도록 마지막 메시지를 얼마나 포함할지에 대한 제한도 있습니다. + +## 관련 항목 + +- [Voice Mode](/ko/voice/) — 대신 응답을 소리내어 들으세요 diff --git a/packages/docs/content/docs/ko/opencode-server.mdx b/packages/docs/content/docs/ko/opencode-server.mdx new file mode 100644 index 00000000..dbb958b3 --- /dev/null +++ b/packages/docs/content/docs/ko/opencode-server.mdx @@ -0,0 +1,54 @@ +--- +title: OpenCode 서버 +description: OpenChamber를 로컬 또는 원격 OpenCode 서버에 연결하세요. +--- + +# OpenCode 서버 + +OpenChamber는 OpenCode 서버 위에서 실행됩니다. 기본적으로 OpenChamber가 서버를 직접 시작하므로 따로 할 일은 없습니다. 이미 운영 중인 서버를 OpenChamber가 사용하도록 지정하거나, OpenChamber가 시작한 서버를 관리하려는 경우에만 이 페이지가 필요합니다. + +## OpenChamber가 서버를 찾는 방법 + +OpenChamber가 시작되면 다음 순서로 서버를 찾습니다. + +1. 이미 시작한 서버를 재사용합니다 +2. 외부 서버를 사용하도록 지정했다면 그 서버에 연결합니다(아래 참고) +3. 기본 포트(`4096`)에서 서버를 자동으로 감지합니다 +4. 그 외에는 자체 서버를 시작하고 관리합니다 + +아무것도 설정하지 않으면 4단계가 자동으로 실행되어 바로 사용할 수 있습니다. + +## 이미 운영 중인 서버에 연결하기 + +OpenChamber를 시작하기 전에 다음을 설정하세요. + +```bash +OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber +``` + +- `OPENCODE_HOST` — 포트를 포함한 OpenCode 서버의 전체 주소(예: `http://localhost:4096`)입니다. 끝에 경로가 붙어서는 안 됩니다. +- `OPENCODE_SKIP_START=true` — OpenChamber가 자체 서버를 시작하지 않도록 지정합니다. + +포트만 변경하면 된다면 `OPENCODE_HOST` 대신 `OPENCODE_PORT`를 설정하세요. + +`OPENCODE_HOST`에 포트가 없거나 경로가 붙어 있으면 OpenChamber는 이를 무시하고 자체 서버를 시작하는 방식으로 되돌아갑니다. 예상한 연결이 일어나지 않았다면 시작 로그에서 `[config]` 경고를 확인하세요. + +## CLI에서 서버 관리하기 + +```bash +openchamber status +openchamber logs +openchamber restart +openchamber stop +``` + +`openchamber`만 입력하면 서버가 백그라운드에서 시작됩니다. 터미널에 연결된 상태로 유지하려면 `--foreground`를 추가하세요. + +## "OpenCode is restarting" + +서버가 시작되거나 재시작되는 동안 OpenChamber는 "OpenCode is restarting" 상태를 표시하고 준비가 끝날 때까지 요청을 일시 중지합니다. 실행 직후나 재시작 직후에는 정상적인 동작입니다. 이 상태가 계속 사라지지 않으면 [OpenCode 연결](/ko/troubleshooting/opencode-connection/)을 참고하세요. + +## 관련 항목 + +- [Providers, Models & Agents](/ko/providers/) — 서버가 통신할 대상을 설정합니다 +- [OpenCode 연결](/ko/troubleshooting/opencode-connection/) — 연결되지 않을 때 diff --git a/packages/docs/content/docs/ko/preview.mdx b/packages/docs/content/docs/ko/preview.mdx new file mode 100644 index 00000000..235083f4 --- /dev/null +++ b/packages/docs/content/docs/ko/preview.mdx @@ -0,0 +1,32 @@ +--- +title: 미리보기 및 개발 서버 +description: 실행 중인 개발 서버를 OpenChamber 안에서 여세요. +--- + +# 미리보기 및 개발 서버 + +개발 서버를 시작하면 OpenChamber는 별도의 브라우저 탭이 아니라 앱 안에서 바로 열 수 있습니다. 그래서 채팅 옆에서 사이트를 보고, 콘솔을 캡처하고, 요소를 가리켜 질문할 수 있습니다. + +## 미리보기 열기 + +OpenChamber는 터미널 출력에서 로컬 주소(Vite, Next.js, Astro 같은 도구가 출력하는 `Local:` 줄)를 감시합니다. 발견하면 다음과 같이 동작합니다. + +- 터미널에 **Open preview** 버튼이 나타납니다 +- auto-open이 켜진 [프로젝트 액션](/ko/project-actions/)이 대신 열어줍니다 +- 채팅 메시지의 로컬 링크로도 열 수 있습니다 + +사이트는 사이드 패널에 로드됩니다. 로컬 주소(사용자 자신의 컴퓨터)만 미리볼 수 있습니다. + +## 콘솔과 검사 + +미리보기 패널에서 다음을 할 수 있습니다. + +- 페이지의 **console**(오류, 경고, 로그)을 원하는 대로 필터링하여 확인 +- **inspect**를 켜고 임의의 요소를 클릭한 뒤 그에 대한 메모(선택자, 스타일, 위치, 스크린샷)를 바로 채팅으로 전송 + +이것은 설명 없이 에이전트에게 "여기 이 버튼"이라고 알리는 가장 빠른 방법입니다. + +## 관련 항목 + +- [Project Actions](/ko/project-actions/) — 서버를 시작할 때 자동으로 열기 +- [Desktop Browser](/ko/desktop-browser/) — 데스크톱에서 임의의 페이지에 동일한 도구 사용 diff --git a/packages/docs/content/docs/ko/project-actions.mdx b/packages/docs/content/docs/ko/project-actions.mdx new file mode 100644 index 00000000..8eb7e9c5 --- /dev/null +++ b/packages/docs/content/docs/ko/project-actions.mdx @@ -0,0 +1,28 @@ +--- +title: 프로젝트 작업 +description: 자주 실행하는 명령을 저장하고 클릭 한 번으로 실행하세요. +--- + +# 프로젝트 작업 + +프로젝트 액션은 한 번 저장해 두고 클릭으로 실행하는 셸 명령입니다. 개발 서버, 빌드, 테스트 실행 등이 해당됩니다. 각 프로젝트는 자체 목록을 유지합니다. **Settings → Projects → Project Actions**에서 설정합니다. + +## 액션 추가하기 + +1. **Settings → Projects**를 열고 **Project Actions** 섹션을 찾습니다. +2. 액션을 추가하고 이름을 지정하고 아이콘을 선택하고 실행할 명령을 입력합니다. +3. 저장합니다. + +명령이 특정 운영체제에서만 의미가 있다면 액션을 해당 운영체제로 제한할 수 있습니다. + +## 액션 실행하기 + +액션은 앱 헤더의 메뉴에 있습니다. 하나를 클릭하면 OpenChamber가 프로젝트 폴더의 터미널에서 실행하고, 출력을 볼 수 있도록 터미널 보기로 전환합니다. 같은 메뉴에서 중지할 수 있습니다. + +## 개발 서버 자동 열기 + +서버를 시작하는 액션에 **auto-open URL**을 켭니다. OpenChamber가 출력에서 로컬 주소를 감시하다가 열기를 제안합니다. [Preview & Dev Servers](/ko/preview/)를 참고하세요. 데스크톱에서는 SSH 포트 포워딩을 통해 라우팅할 수도 있습니다. + +## 관련 항목 + +- [Preview & Dev Servers](/ko/preview/) — 실행 중인 개발 서버를 OpenChamber 안에서 여세요 diff --git a/packages/docs/content/docs/ko/project-icons.mdx b/packages/docs/content/docs/ko/project-icons.mdx new file mode 100644 index 00000000..e21ea6a5 --- /dev/null +++ b/packages/docs/content/docs/ko/project-icons.mdx @@ -0,0 +1,20 @@ +--- +title: 프로젝트 아이콘 +description: 각 프로젝트에 알아보기 쉬운 아이콘을 지정하세요. +--- + +# 프로젝트 아이콘 + +프로젝트 아이콘은 한눈에 프로젝트를 구분하기 쉽게 해줍니다. OpenChamber가 아이콘을 찾아주려고 시도하며, 언제든 직접 설정할 수 있습니다. **Settings → Projects**에서 관리합니다. + +## 자동 검색 + +프로젝트를 추가하면 OpenChamber가 그 안의 `favicon` 파일을 찾아 프로젝트 아이콘으로 사용합니다. 저장소에 이미 favicon이 있으면 대개 아이콘이 그냥 나타나며, 할 일이 없습니다. + +## 직접 설정하기 + +**Settings → Projects**를 열고 이미지(PNG, JPEG 또는 SVG, 최대 5 MB)를 업로드합니다. 사용자 지정 이미지는 자동으로 검색된 것보다 우선합니다. 대신 색상을 선택할 수도 있고, 이미지를 제거해 검색으로 되돌릴 수도 있습니다. + +## 관련 항목 + +- [Projects](/ko/projects/) — 프로젝트의 이름, 색상을 정하고 정리하세요 diff --git a/packages/docs/content/docs/ko/projects.mdx b/packages/docs/content/docs/ko/projects.mdx new file mode 100644 index 00000000..4b11bb7d --- /dev/null +++ b/packages/docs/content/docs/ko/projects.mdx @@ -0,0 +1,34 @@ +--- +title: 프로젝트 +description: 작업을 프로젝트로 정리하고 그 사이를 전환하세요. +--- + +# 프로젝트 + +프로젝트는 OpenChamber가 추적하는 사용자 컴퓨터의 폴더로, 보통 하나의 코드베이스입니다. 프로젝트를 전환하면 에이전트가 작업하는 폴더가 그 프로젝트의 세션 및 설정과 함께 전환됩니다. + +## 프로젝트 추가하기 + +몇 군데에서 프로젝트를 추가할 수 있습니다. + +- 명령 팔레트의 **Add project** 항목 +- 세션 사이드바 상단의 **+** 버튼 +- 디렉터리를 선택할 때 나오는 폴더 브라우저 + +폴더를 지정하면 OpenChamber가 기억합니다. 이름은 폴더에서 가져오며, 나중에 변경할 수 있습니다. + +## 프로젝트 전환하기 + +사이드바에서 프로젝트를 선택하면 활성화됩니다. 세션, git, 노트 등 모든 것이 열려 있는 프로젝트를 따릅니다. + +## 프로젝트를 알아보기 쉽게 만들기 + +**Settings → Projects**를 열어 프로젝트에 사용자 지정 이름, 색상, 아이콘을 지정합니다. OpenChamber는 아이콘을 자동으로 찾으려고 시도합니다. [Project icons](/ko/project-icons/)를 참고하세요. + +> VS Code에서는 OpenChamber가 항상 열려 있는 폴더를 유일한 프로젝트로 사용하므로 추가하거나 전환할 것이 없습니다. 거기서는 Projects 설정 페이지가 숨겨집니다. + +## 관련 항목 + +- [Project Notes, Todos & Plans](/ko/notes-todos-plans/) — 프로젝트별로 작업 노트를 유지하세요 +- [Project Actions](/ko/project-actions/) — 자주 실행하는 명령을 저장하세요 +- [Context](/ko/context/) — 세션이 모델의 메모리를 얼마나 사용하는지 확인하세요 diff --git a/packages/docs/content/docs/ko/providers.mdx b/packages/docs/content/docs/ko/providers.mdx new file mode 100644 index 00000000..16869b26 --- /dev/null +++ b/packages/docs/content/docs/ko/providers.mdx @@ -0,0 +1,49 @@ +--- +title: 공급자, 모델, 에이전트 +description: AI 공급자를 연결하고 모델을 선택하며 에이전트를 설정하세요. +--- + +# 공급자, 모델, 에이전트 + +OpenChamber가 무언가를 하려면 먼저 최소한 하나의 AI 공급자가 연결되어 있어야 합니다. 이 페이지에서는 공급자 연결, 모델 선택, 에이전트 맞춤 설정을 다룹니다. + +## 공급자 연결하기 + +1. **Settings → Providers**를 엽니다. +2. **Add provider** 메뉴를 열고 아직 연결되지 않은 공급자를 선택합니다. +3. 공급자에 따라 다음 두 가지 방법 중 하나로 로그인합니다. + - **API key** — 키를 붙여넣고 저장합니다. + - **Sign-in (device flow)** — OpenChamber가 링크와 짧은 코드를 표시합니다. 링크를 열고 코드를 입력한 뒤 승인합니다. 나머지 연결은 OpenChamber가 알아서 마무리합니다. + +공급자가 연결됨으로 표시되면 해당 모델을 채팅에서 사용할 수 있습니다. + +연결을 해제하려면 공급자를 열고 로그인을 제거하도록 선택합니다. + +## 모델 선택하기 + +작업하는 위치에서 모델을 선택합니다. + +- 채팅에서는 메시지 바의 모델 선택기로 해당 세션의 공급자와 모델을 설정합니다 +- 에이전트별로 기본 모델을 설정합니다(아래 참고) + +## 에이전트 설정하기 + +에이전트는 모델, 성격, 허용된 작업을 묶어 이름을 붙인 설정입니다. + +1. **Settings → Agents**를 엽니다. +2. 에이전트를 선택하거나 새로 만듭니다. +3. 다음 항목을 편집합니다. + - **description** — 에이전트의 용도 + - **model** — 기본 모델 + - **temperature** — 답변의 창의성 정도 + - **prompt** — 항상 따르는 상시 지침 + - **tool rules** — 사용할 수 있는 도구 + +## 로그인 정보가 저장되는 위치 + +공급자 로그인 정보는 OpenChamber가 아니라 OpenCode에 저장되므로 OpenCode CLI와 공유됩니다. 같은 공급자를 여러 곳에 설정하면 가장 구체적인 설정이 우선합니다. 프로젝트별 설정이 개인 설정을 덮어씁니다. + +## 관련 항목 + +- [MCP Servers](/ko/mcp/) — 에이전트에 추가 도구를 제공합니다 +- [Usage & Quotas](/ko/usage/) — 사용량을 추적합니다 diff --git a/packages/docs/content/docs/ko/remote-instances.mdx b/packages/docs/content/docs/ko/remote-instances.mdx new file mode 100644 index 00000000..ee2cc776 --- /dev/null +++ b/packages/docs/content/docs/ko/remote-instances.mdx @@ -0,0 +1,30 @@ +--- +title: 원격 인스턴스 +description: 데스크톱 앱을 SSH로 다른 컴퓨터의 OpenChamber에 연결하세요. +--- + +# 원격 인스턴스 + +데스크톱 앱은 SSH를 통해 업무 서버, 클라우드 인스턴스, 홈랩 등 다른 컴퓨터에서 실행 중인 OpenChamber에 연결하여, 마치 로컬인 것처럼 그 UI를 화면에 가져올 수 있습니다. **Settings → Remote Instances**에서 설정합니다. + +> 원격 인스턴스는 **데스크톱 전용** 기능입니다. 웹이나 VS Code에서는 대신 [OpenCode Server](/ko/opencode-server/)의 환경 변수로 원격 서버에 연결하세요. + +## 원격 인스턴스 추가하기 + +1. **Settings → Remote Instances**를 열고 하나를 추가합니다. +2. 평소에 그 컴퓨터에 접근할 때 사용하는 SSH 명령과 별칭을 지정합니다. +3. OpenChamber가 거기서 실행되는 방식을 선택합니다. + - **managed** — OpenChamber가 원격 컴퓨터에 직접 설치하고 시작합니다 + - **external** — 이미 실행 중인 것에 연결합니다 +4. 연결합니다. + +OpenChamber가 연결 확인, 원격 설정, 서버 시작, 포트 포워딩 단계를 안내하며 각 단계의 진행 상황을 보여줍니다. **ready**에 도달하면 원격 UI가 로컬에 로드됩니다. + +## 자격 증명 + +SSH 및 UI 비밀번호를 저장할지, 매번 입력할지 결정합니다. 연결이 끊기면 OpenChamber가 어느 단계가 실패했는지 알려주므로 고칠 수 있습니다. [Remote access](/ko/troubleshooting/remote-access/)를 참고하세요. + +## 관련 항목 + +- [OpenCode Server](/ko/opencode-server/) — 웹이나 VS Code에서 원격 서버에 연결하세요 +- [Remote access](/ko/troubleshooting/remote-access/) — 연결이 완료되지 않을 때 diff --git a/packages/docs/content/docs/ko/scheduled-tasks.mdx b/packages/docs/content/docs/ko/scheduled-tasks.mdx new file mode 100644 index 00000000..aef273e9 --- /dev/null +++ b/packages/docs/content/docs/ko/scheduled-tasks.mdx @@ -0,0 +1,33 @@ +--- +title: 예약 작업 +description: 일정에 따라 프롬프트를 자동으로 실행하세요. +--- + +# 예약 작업 + +예약 작업은 일정에 따라 프롬프트를 대신 실행합니다. 예를 들어 매일 "어제 변경 사항 요약"이나 주간 정리 같은 것입니다. 실행되면 OpenChamber가 새 세션을 시작하고 프롬프트를 알아서 보냅니다. 세션 사이드바 상단의 버튼에서 스케줄러를 엽니다. + +## 작업 만들기 + +1. 세션 사이드바에서 예약 작업 대화 상자를 엽니다. +2. 작업을 추가하고 이름을 지정합니다. +3. 실행 시점을 선택합니다. + - **daily** — 매일 하나 이상의 시각에 + - **weekly** — 선택한 요일과 시각에 + - **once** — 단일 날짜와 시각에 +4. 동작을 설정합니다. 보낼 프롬프트와 사용할 공급자, 모델, 에이전트를 지정합니다. 프롬프트는 `/review`처럼 슬래시 명령일 수 있습니다. +5. 저장하고 작업이 활성화되어 있는지 확인합니다. + +**run now**로 작업을 즉시 실행하여 기대대로 동작하는지 확인할 수 있습니다. + +## 성공이란 어떤 모습인가 + +실행 후 작업에는 마지막 실행 시각, 성공 여부, 생성된 세션으로의 링크가 표시됩니다. 실행이 실패하면 오류도 거기에 표시됩니다. + +## 유의할 점 + +작업은 OpenChamber 서버가 실행 중일 때만 동작합니다. 서버를 닫으면 다시 켤 때까지 예약 실행이 일시 중지됩니다. + +## 관련 항목 + +- [Commands & Snippets](/ko/commands-snippets/) — 슬래시 명령을 프롬프트로 재사용하세요 diff --git a/packages/docs/content/docs/ko/security.mdx b/packages/docs/content/docs/ko/security.mdx new file mode 100644 index 00000000..04c2f53a --- /dev/null +++ b/packages/docs/content/docs/ko/security.mdx @@ -0,0 +1,37 @@ +--- +title: 보안 +description: 노출하기 전에 비밀번호와 패스키로 UI를 보호하세요. +--- + +# 보안 + +OpenChamber는 사용자의 컴퓨터와 코드에 대한 접근 권한을 제공하므로, 본인 외의 누군가가 접근할 수 있게 되기 전에 잠가 두세요. 이 페이지는 UI 비밀번호, 패스키, 그리고 OpenChamber를 네트워크에 노출하기 전에 알아야 할 사항을 다룹니다. + +## UI 비밀번호 설정하기 + +비밀번호와 함께 OpenChamber를 시작하면 브라우저 UI가 비밀번호를 요구합니다. + +```bash +openchamber --ui-password be-creative-here +``` + +명령줄에 넣는 대신 `OPENCHAMBER_UI_PASSWORD` 환경 변수로 설정할 수도 있습니다. 로그인하면 OpenChamber가 한동안 기기를 기억하므로 매번 묻지 않습니다. + +다른 사람이 인스턴스에 접근할 수 있다면, 특히 [터널](/ko/tunnels/)이나 공용 인터넷을 통해 접근할 수 있다면 항상 비밀번호를 설정하세요. + +## 패스키 + +비밀번호가 설정되면 더 빠른 로그인을 위해 패스키(Face ID, Touch ID, 보안 키)를 추가할 수 있습니다. **Settings → OpenChamber → Passkeys**에서 추가하세요. + +패스키는 현재 비밀번호에 연결됩니다. 비밀번호를 변경하거나 제거하면 저장된 패스키가 삭제되며, 다시 추가해야 합니다. + +## 노출하기 전에 + +- 기본적으로 OpenChamber는 사용자 자신의 컴퓨터(`127.0.0.1`)에서만 수신 대기합니다. 더 넓게 수신 대기하려면 의도적인 변경이 필요하며, 먼저 비밀번호를 설정해야 합니다. +- 인터넷에 포트를 여는 것보다 [터널](/ko/tunnels/)이나 사설 네트워크(예: VPN)를 선호하세요. +- OpenChamber를 자체 HTTPS 서버 뒤에 둔다면 [Reverse Proxy](/ko/reverse-proxy/)를 참고하세요. + +## 관련 항목 + +- [Tunnels](/ko/tunnels/) — 원격으로 인스턴스에 접근하는 권장 방법 +- [Reverse Proxy](/ko/reverse-proxy/) — 자체 서버 뒤에서 OpenChamber 실행 diff --git a/packages/docs/content/docs/ko/skills-catalog.mdx b/packages/docs/content/docs/ko/skills-catalog.mdx new file mode 100644 index 00000000..664241a0 --- /dev/null +++ b/packages/docs/content/docs/ko/skills-catalog.mdx @@ -0,0 +1,27 @@ +--- +title: 스킬 카탈로그 +description: 이미 만들어진 스킬을 둘러보고 설치하세요. +--- + +# 스킬 카탈로그 + +Skills Catalog를 사용하면 직접 작성하는 대신 다른 사람이 게시한 스킬을 설치할 수 있습니다. **Settings → Skills → Catalog**에서 엽니다. + +직접 스킬을 작성하려면 [Skills](/ko/skills/)를 참고하세요. + +## 스킬 설치하기 + +1. 카탈로그를 엽니다. +2. 내장된 소스(Anthropic 스킬 저장소와 ClawdHub 커뮤니티 레지스트리)를 둘러보거나 검색합니다. +3. 스킬을 선택하고 설치합니다. +4. 설치 위치를 선택합니다. 모든 작업에 적용할지, 현재 프로젝트에만 적용할지 선택합니다. + +같은 이름의 스킬이 이미 있으면 OpenChamber가 어떻게 할지 묻습니다. 건너뛰기, 덮어쓰기, 또는 스킬별로 결정할 수 있습니다. + +## 직접 소스 추가하기 + +`owner/repo` 이름이나 전체 Git URL을 사용해 임의의 Git 저장소를 소스로 추가할 수 있습니다. 비공개 저장소는 사용자의 컴퓨터에 접근 설정(SSH 키 또는 저장된 자격 증명)이 필요합니다. 소스가 인증에 실패하면 카탈로그가 조용히 실패하는 대신 그 사실을 알려줍니다. + +## 관련 항목 + +- [Skills](/ko/skills/) — 설치한 스킬을 만들고 관리하세요 diff --git a/packages/docs/content/docs/ko/skills.mdx b/packages/docs/content/docs/ko/skills.mdx new file mode 100644 index 00000000..29626364 --- /dev/null +++ b/packages/docs/content/docs/ko/skills.mdx @@ -0,0 +1,30 @@ +--- +title: 스킬 +description: 에이전트가 필요할 때 불러오는 재사용 가능한 지침을 만드세요. +--- + +# 스킬 + +스킬은 에이전트가 관련이 있을 때 불러올 수 있는 재사용 가능한 지침 모음입니다. 예를 들어 "커밋 메시지를 작성하는 방식"이나 "우리의 API 규칙" 같은 것입니다. **Settings → Skills**에서 관리합니다. + +직접 작성하는 대신 이미 만들어진 스킬을 설치하려면 [Skills Catalog](/ko/skills-catalog/)를 참고하세요. + +## 스킬 만들기 + +1. **Settings → Skills**를 엽니다. +2. 스킬을 만들고 이름과 짧은 설명을 지정합니다. 에이전트는 이 설명을 보고 스킬이 적용될 시점을 판단하므로 구체적으로 작성하세요. +3. 지침을 작성합니다. 스킬에 필요하다면 보조 파일을 추가합니다. +4. 저장 위치를 선택합니다. + - **personal** — 모든 프로젝트에서 사용 가능 + - **project** — 현재 프로젝트에서만 사용 가능 + +## 채팅에서 스킬 사용하기 + +메시지 중간에 `/`를 입력하면 스킬 선택기가 나타나며, 그중 하나를 선택합니다. 에이전트가 해당 스킬의 지침을 응답에 불러옵니다. + +메시지 맨 앞의 `/`는 대신 [명령](/ko/commands-snippets/)을 엽니다. + +## 관련 항목 + +- [Skills Catalog](/ko/skills-catalog/) — 다른 사람이 게시한 스킬을 설치하세요 +- [Commands & Snippets](/ko/commands-snippets/) — 채팅에서 텍스트를 재사용하는 다른 방법 diff --git a/packages/docs/content/docs/ko/troubleshooting/opencode-connection.mdx b/packages/docs/content/docs/ko/troubleshooting/opencode-connection.mdx new file mode 100644 index 00000000..7ffee711 --- /dev/null +++ b/packages/docs/content/docs/ko/troubleshooting/opencode-connection.mdx @@ -0,0 +1,34 @@ +--- +title: OpenCode 연결 +description: OpenChamber가 OpenCode 서버에 연결되지 않는 문제를 해결하세요. +--- + +# OpenCode 연결 + +OpenChamber가 로드되지만 "OpenCode is restarting"에서 넘어가지 못하거나 채팅이 응답하지 않는다면, 통신하는 서버에 접근할 수 없는 상태입니다. 다음을 차례로 확인하세요. + +## "OpenCode is restarting"에서 멈춰 있음 + +- 실행 직후에는 잠시 기다리세요. 서버가 시작되는 동안에는 정상적인 상태입니다 +- `openchamber status`로 서버가 살아 있는지 확인합니다 +- `openchamber restart`로 재시작합니다 +- `openchamber logs`로 시작 세부 정보를 봅니다 + +## 직접 운영하는 서버에 연결 중 + +OpenChamber가 기존 서버를 사용하도록 설정했다면 [OpenCode Server](/ko/opencode-server/)의 설정을 다시 확인하세요. + +- `OPENCODE_HOST`에는 포트가 포함되어야 하며 경로가 없어야 합니다(예: `http://localhost:4096`) +- OpenChamber가 자체 서버를 함께 시작하지 않도록 `OPENCODE_SKIP_START=true`를 설정합니다 +- 주소가 올바르지 않으면 OpenChamber가 이를 무시하고 자체 서버를 시작합니다. 로그에서 `[config]` 경고를 찾아보세요 + +## 여전히 실패함 + +- Node.js 버전이 `20` 이상인지 확인합니다 +- 최신 CLI를 다시 설치합니다 +- 터널이나 원격 링크를 테스트하기 전에 `http://localhost:3000`을 직접 엽니다 + +## 관련 항목 + +- [OpenCode Server](/ko/opencode-server/) — OpenChamber가 서버를 찾고 관리하는 방법 +- [문제 해결](/ko/troubleshooting/) — 다른 일반적인 문제 diff --git a/packages/docs/content/docs/ko/troubleshooting/remote-access.mdx b/packages/docs/content/docs/ko/troubleshooting/remote-access.mdx new file mode 100644 index 00000000..0a0ff10b --- /dev/null +++ b/packages/docs/content/docs/ko/troubleshooting/remote-access.mdx @@ -0,0 +1,38 @@ +--- +title: 원격 접속 +description: 터널, 원격 인스턴스, 다른 기기에서 OpenChamber에 접근하는 문제를 해결하세요. +--- + +# 원격 접속 + +휴대폰이나 다른 컴퓨터에서 OpenChamber에 접근할 수 없을 때, 해결 방법은 연결 방식에 따라 다릅니다. + +## 먼저 기본 사항 확인 + +- 같은 컴퓨터에서 `http://localhost:3000`을 먼저 엽니다. 이것이 실패하면 원격 문제가 아닙니다. [OpenCode 연결](/ko/troubleshooting/opencode-connection/)을 참고하세요 +- `openchamber status`로 서버가 실행 중인지 확인합니다 + +## 터널 링크가 작동하지 않음 + +- `openchamber tunnel status --all`을 실행합니다 +- 같은 인스턴스와 포트에서 터널을 재시작합니다 +- 이전 링크가 이미 사용되었다면 연결 링크를 다시 생성합니다 + +전체 설정은 [Tunnels](/ko/tunnels/)를 참고하세요. + +## 원격 인스턴스가 연결되지 않음(데스크톱) + +[원격 인스턴스](/ko/remote-instances/)가 멈추면 OpenChamber가 실패한 단계를 알려줍니다. + +- **auth** — SSH 또는 UI 비밀번호가 거부됨. 다시 입력하세요 +- **install / start** — OpenChamber가 원격 컴퓨터에서 서버를 설정하거나 시작하지 못함. 그 컴퓨터의 요구 사항을 확인하세요 +- **forwarding** — 연결은 되었지만 포트가 도달하지 않음. 다른 로컬 포트를 시도하세요 + +## 자체 서버 뒤에 있음 + +OpenChamber를 리버스 프록시 뒤에 두었는데 이상하게 로드되거나 연결되지 않으면 [Reverse Proxy](/ko/reverse-proxy/)를 참고하세요. + +## 관련 항목 + +- [Tunnels](/ko/tunnels/) · [Remote Instances](/ko/remote-instances/) · [Reverse Proxy](/ko/reverse-proxy/) +- [Security](/ko/security/) — 노출하기 전에 UI를 보호하세요 diff --git a/packages/docs/content/docs/ko/troubleshooting/worktrees-git.mdx b/packages/docs/content/docs/ko/troubleshooting/worktrees-git.mdx new file mode 100644 index 00000000..86883206 --- /dev/null +++ b/packages/docs/content/docs/ko/troubleshooting/worktrees-git.mdx @@ -0,0 +1,35 @@ +--- +title: Worktree 및 Git +description: 일반적인 worktree 및 git 문제를 해결하세요. +--- + +# Worktree 및 Git + +[worktree 세션](/ko/worktrees/)과 [git 보기](/ko/git/)에서 발생하는 문제와 해결 방법입니다. + +## worktree에 주의가 필요함 + +OpenChamber는 무언가 잘못되면 worktree를 표시합니다. + +- **folder missing** — worktree의 폴더가 OpenChamber 외부에서 삭제되거나 이동됨. 세션을 제거하고 새 worktree를 만드세요 +- **detached or unborn branch** — worktree가 정상적인 브랜치에 있지 않음. 정상 브랜치로 체크아웃하세요 +- **merge, rebase, or cherry-pick in progress** — 작업이 절반만 끝남. git 보기에서 완료하거나 중단하세요 + +## worktree를 만들 수 없음 + +- **branch already exists** — 다른 브랜치 이름을 선택하거나 existing-branch 옵션을 사용하세요 +- **name already in use** — 다른 worktree 이름을 선택하세요 + +## 커밋 또는 PR 생성 실패 + +커밋 메시지나 PR 설명 생성은 활성 세션에서 실행되므로, 작동하는 모델이 선택된 세션이 열려 있어야 합니다. 세션을 열거나 선택한 뒤 다시 시도하세요. + +## SSH 또는 Windows 경로 문제 + +- 저장소가 사용하는 SSH 키가 [git 신원](/ko/git-identities/)에 설정된 것과 같은지 확인하세요 +- Windows에서 git은 Unix 스타일 경로(예: `/c/Users/...`)를 사용합니다. OpenChamber가 이를 처리하지만, 사용자 지정 SSH 키 경로도 같은 형식을 따라야 합니다 + +## 관련 항목 + +- [Worktree Sessions](/ko/worktrees/) — worktree가 생성되고 제거되는 방법 +- [Git Identities](/ko/git-identities/) — 저장소마다 올바른 키와 신원을 설정하세요 diff --git a/packages/docs/content/docs/ko/tunnels.mdx b/packages/docs/content/docs/ko/tunnels.mdx index b213d219..9f580e31 100644 --- a/packages/docs/content/docs/ko/tunnels.mdx +++ b/packages/docs/content/docs/ko/tunnels.mdx @@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000 ## 관련 문서 +- [보안](/ko/security/) — 외부에 공개하기 전에 UI를 보호하세요 +- [PWA 및 모바일 접속](/ko/mobile/) — 휴대폰에서 OpenChamber에 접속하세요 - [문제 해결](/ko/troubleshooting/) — 터널 링크가 작동하지 않을 때 diff --git a/packages/docs/content/docs/ko/updates.mdx b/packages/docs/content/docs/ko/updates.mdx new file mode 100644 index 00000000..46f31438 --- /dev/null +++ b/packages/docs/content/docs/ko/updates.mdx @@ -0,0 +1,31 @@ +--- +title: 업데이트 +description: 데스크톱, 웹, VS Code에서 OpenChamber를 최신 상태로 유지하세요. +--- + +# 업데이트 + +OpenChamber를 업데이트하는 방법은 설치 방식에 따라 다릅니다. 어떤 경우든 **Settings → OpenChamber → About**에서 현재 버전을 확인할 수 있습니다. + +## 데스크톱 앱 + +데스크톱 앱은 GitHub 릴리스를 기준으로 업데이트를 확인합니다. 업데이트가 있으면 OpenChamber가 알려주고, 선택하면 다운로드한 뒤 다음 재시작 때 설치합니다. 항상 사용자가 제어하며, 동의 없이는 아무것도 설치되지 않습니다. + +## 웹 / CLI + +CLI를 설치했다면 **About**의 확인 및 업데이트 버튼으로 업데이트하거나, 터미널에서 업데이트합니다. + +```bash +openchamber update +``` + +OpenChamber는 설치 방식(npm, pnpm, yarn 또는 bun)을 감지하여 알맞은 업데이트를 실행합니다. + +## OpenCode 서버 + +OpenChamber와 OpenCode는 별도로 업데이트됩니다. 새 OpenCode 버전이 있으면 OpenChamber가 업데이트를 제안하고, 이후 서버를 재시작합니다. 그 서버가 관리되는 방식은 [OpenCode Server](/ko/opencode-server/)를 참고하세요. + +## 관련 항목 + +- [Install](/ko/install/) — 각 앱이 처음에 설치되는 방법 +- [OpenCode Server](/ko/opencode-server/) — 기반 서버 업데이트 diff --git a/packages/docs/content/docs/ko/usage.mdx b/packages/docs/content/docs/ko/usage.mdx new file mode 100644 index 00000000..7829c3d3 --- /dev/null +++ b/packages/docs/content/docs/ko/usage.mdx @@ -0,0 +1,28 @@ +--- +title: 사용량 및 할당량 +description: 공급자 요금제를 얼마나 사용했는지 추적하세요. +--- + +# 사용량 및 할당량 + +Usage 페이지는 각 공급자 요금제를 얼마나 사용했는지 보여주므로 한도에 얼마나 가까운지 확인할 수 있습니다. **Settings → Usage**에서 엽니다. + +## 표시되는 내용 + +연결된 각 공급자에 대해 OpenChamber는 다음을 표시합니다. + +- 현재 기간 동안 사용한 양을 막대로 표시 +- 모델별 분석 +- 한도에 도달할 추세인지 알 수 있는 사용 속도 지표 + +어떤 공급자를 표시할지 선택할 수 있으며, 동일한 요약은 앱 헤더의 드롭다운에서도 확인할 수 있습니다. + +## 지원되는 공급자 + +Usage는 Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud, Wafer를 포함해 할당량을 공개하는 공급자에서 작동합니다. + +공급자는 [Providers](/ko/providers/) 페이지에서 로그인한 뒤에만 사용량을 표시합니다. 일부 공급자는 추가 단계가 필요합니다. 예를 들어 Ollama Cloud는 별도로 설정한 세션 파일을 읽습니다. 공급자에 데이터가 표시되지 않는다면 대개 그 추가 자격 증명이 누락된 것입니다. + +## 관련 항목 + +- [Providers, Models & Agents](/ko/providers/) — 사용량이 표시되기 전에 로그인하세요 diff --git a/packages/docs/content/docs/ko/voice.mdx b/packages/docs/content/docs/ko/voice.mdx new file mode 100644 index 00000000..43180228 --- /dev/null +++ b/packages/docs/content/docs/ko/voice.mdx @@ -0,0 +1,36 @@ +--- +title: 음성 모드 +description: OpenChamber에 말하고 응답을 소리내어 들으세요. +--- + +# 음성 모드 + +음성 모드를 사용하면 메시지를 받아쓰게 하고 응답을 소리내어 들을 수 있습니다. **Settings → OpenChamber → Voice**에서 켭니다. + +## 응답을 소리내어 읽기(text-to-speech) + +응답을 읽는 방식을 선택합니다. + +- **browser** — 브라우저의 내장 음성, 설정 불필요 +- **OpenAI** — OpenAI의 음성. API 키를 붙여넣고 음성을 선택합니다 +- **OpenAI-compatible** — OpenAI 형식을 지원하는 모든 서비스. URL과, 필요하다면 API 키를 입력합니다 +- **macOS say** — 내장 `say` 명령. 이를 지원하는 Mac에서 사용 가능 + +켜면 메시지에 재생 버튼이 생겨 소리내어 들을 수 있습니다. + +## 메시지 받아쓰기(speech-to-text) + +음성을 텍스트로 변환하는 방식을 선택합니다. + +- **browser** — 브라우저의 내장 인식, 설정 불필요 +- **server** — OpenAI 호환 변환 서비스. URL과, 필요하다면 API 키를 입력합니다 +- **on-device** — 브라우저에서 실행되며 처음 사용할 때 다운로드되는 음성 모델 + +## 휴대폰 관련 참고 사항 + +휴대폰에서 응답을 소리내어 읽을 때는 OpenAI 또는 OpenAI-compatible 옵션이 가장 안정적입니다. 모바일 브라우저는 내장 음성을 제한합니다. + +## 관련 항목 + +- [Notifications](/ko/notifications/) — 듣는 대신 알림을 받으세요 +- [Providers, Models & Agents](/ko/providers/) — OpenAI 키가 이미 저장되어 있을 수 있는 곳 diff --git a/packages/docs/content/docs/ko/worktrees.mdx b/packages/docs/content/docs/ko/worktrees.mdx new file mode 100644 index 00000000..f241b592 --- /dev/null +++ b/packages/docs/content/docs/ko/worktrees.mdx @@ -0,0 +1,36 @@ +--- +title: Worktree 세션 +description: 세션에 자체 브랜치와 폴더를 부여하여 작업을 격리하세요. +--- + +# Worktree 세션 + +worktree 세션은 자체 브랜치 위에서 체크아웃된 저장소 사본으로 실행됩니다(git worktree). 그래서 병렬 세션이 서로의 파일을 건드리지 않으며, 한 세션이 리팩터링하는 동안 다른 세션이 버그를 고칠 수 있고 오갈 필요가 없습니다. + +## 만들기 + +1. 세션 사이드바 상단의 버튼에서 새 worktree 대화 상자를 엽니다. +2. 시작 지점을 선택합니다. + - **new branch** — 브랜치 이름을 지정하고 어느 브랜치에서 시작할지 선택합니다 + - **existing branch** — 이미 가지고 있는 브랜치를 체크아웃합니다 +3. worktree 폴더를 확인합니다(OpenChamber가 브랜치 이름에서 하나를 제안합니다). +4. 만듭니다. + +OpenChamber가 브랜치를 만들고 폴더를 설정한 뒤 그 안에서 세션을 시작합니다. [할 일](/ko/notes-todos-plans/)이나 [GitHub 이슈 또는 PR](/ko/github/)에서 바로 시작할 수도 있습니다. + +## 작업 되돌려 가져오기 + +작업이 만족스러우면 Git 보기에서 **Integrate**를 사용해 worktree의 커밋을 다른 브랜치(예: `main`)로 가져옵니다. 변경 사항이 충돌하면 충돌을 에이전트에게 넘겨 해결하게 할 수 있습니다. + +## 정리하기 + +세션을 삭제하거나 보관하면 worktree를 제거할 수 있습니다. 로컬 브랜치와, 있다면 원격 브랜치까지 함께 삭제할지 선택합니다. 요청하지 않으면 아무것도 삭제되지 않습니다. + +## 무언가 잘못된 것처럼 보이면 + +worktree는 폴더가 사라졌거나, 브랜치가 detached 상태이거나, 병합 또는 리베이스가 절반만 끝난 경우 주의가 필요할 수 있습니다. OpenChamber가 이를 표시하여 고칠 수 있게 합니다. [Worktrees & Git](/ko/troubleshooting/worktrees-git/)을 참고하세요. + +## 관련 항목 + +- [Multi-run](/ko/multi-run/) — 여러 worktree 세션을 한 번에 시작하세요 +- [Git & GitHub Workflows](/ko/git/) — OpenChamber 안에서 커밋하고 통합하세요 diff --git a/packages/docs/content/docs/magic-prompts.mdx b/packages/docs/content/docs/magic-prompts.mdx new file mode 100644 index 00000000..ba830e09 --- /dev/null +++ b/packages/docs/content/docs/magic-prompts.mdx @@ -0,0 +1,26 @@ +--- +title: Magic Prompts +description: Customize the built-in prompts behind OpenChamber's automated flows. +--- + +# Magic Prompts + +OpenChamber uses built-in prompts behind the scenes whenever it does something automatically — writing a commit message, drafting a PR, reviewing an issue, resolving a conflict, summarizing a session. Magic Prompts is where you read and rewrite those prompts. Open it at **Settings → Magic Prompts**. + +You don't need this page for normal use. Reach for it when you want a flow to behave differently — say, commit messages in a particular style. + +## Edit a prompt + +1. Open **Settings → Magic Prompts**. +2. Pick a prompt from the groups in the sidebar — Git, GitHub, Planning, and Session. +3. Edit the text and save. + +Some prompts have a visible part (the message you'd see) and an instructions part (hidden guidance for the agent). Prompts can include `{{placeholders}}` that OpenChamber fills in, like the diff or the issue title — keep those in place. + +## Reset + +Changed your mind? Each prompt has **reset to default**, and there's a **reset all** if you want to start over everywhere. + +## Related + +- [Git & GitHub Workflows](/git/) — many of these prompts power the git flows diff --git a/packages/docs/content/docs/mcp.mdx b/packages/docs/content/docs/mcp.mdx new file mode 100644 index 00000000..227d3afd --- /dev/null +++ b/packages/docs/content/docs/mcp.mdx @@ -0,0 +1,30 @@ +--- +title: MCP Servers +description: Add MCP servers to give agents extra tools. +--- + +# MCP Servers + +An MCP server gives your agents extra tools — things like searching a database, calling an API, or reading a service you use. Add them in **Settings → MCP**. + +## Add a server + +1. Open **Settings → MCP**. +2. Add a server and choose its type: + - **local** — OpenChamber runs a command on your machine. You give it the command to run and, if needed, environment variables. + - **remote** — OpenChamber connects to a URL someone else hosts. You give it the URL and any headers it needs (for example an auth token). +3. Save. The server is on by default; you can turn it off without deleting it. + +## Where it applies + +Pick the scope when you add a server: + +- **personal** — available in every project +- **project** — available only in the current project, and saved alongside the project's other settings + +Server names use lowercase letters, numbers, hyphens, and underscores. + +## Related + +- [Providers, Models & Agents](/providers/) — connect a model first +- [Skills](/skills/) — another way to extend what agents can do diff --git a/packages/docs/content/docs/mobile.mdx b/packages/docs/content/docs/mobile.mdx new file mode 100644 index 00000000..eddbf1ef --- /dev/null +++ b/packages/docs/content/docs/mobile.mdx @@ -0,0 +1,31 @@ +--- +title: PWA & Mobile Access +description: Install OpenChamber as an app and use it from your phone. +--- + +# PWA & Mobile Access + +The OpenChamber web app installs like a phone app (a PWA), so you can keep it on your home screen and use it full-screen. Pair it with a [tunnel](/tunnels/) and you can check in on a session from anywhere. + +## Install it + +OpenChamber uses your browser's built-in install, so there's no separate download: + +- **desktop browser** — use the **Install** option in the address bar +- **iPhone/iPad (Safari)** — Share → **Add to Home Screen** +- **Android (Chrome)** — menu → **Install app** / **Add to Home Screen** + +Once installed, it opens in its own window without browser chrome. + +## Reach it from your phone + +To open OpenChamber on your phone when the server runs on your computer, start a [tunnel](/tunnels/) and open the link (or scan the QR code) on the phone. Use a strong [UI password](/security/) whenever you do this. + +## Mobile settings + +Under **Settings → OpenChamber**, a few options tune the mobile and installed experience — the app's installed name, screen orientation, and how the on-screen keyboard behaves. + +## Related + +- [Tunnels](/tunnels/) — reach your instance from another network +- [Security](/security/) — protect the UI before exposing it diff --git a/packages/docs/content/docs/multi-run.mdx b/packages/docs/content/docs/multi-run.mdx new file mode 100644 index 00000000..985d58fa --- /dev/null +++ b/packages/docs/content/docs/multi-run.mdx @@ -0,0 +1,34 @@ +--- +title: Multi-run +description: Run the same prompt across several models or sessions at once. +--- + +# Multi-run + +Multi-run launches several sessions from one form — handy for trying the same task with different models and comparing the results. Open it from the button at the top of the session sidebar. + +## Start a multi-run + +1. Open the multi-run launcher. +2. Pick the project and name the run group. +3. Write the prompt and pick the models to run it with (up to five per group). +4. Choose whether to **isolate runs**. +5. Launch. + +Each model gets its own session, and they all start with your prompt. + +## Isolated runs + +Turn on **isolate runs** to give every run its own [worktree](/worktrees/) and branch, so they never touch the same files. This needs a git repo — it's turned off automatically for folders that aren't one. Pick the branch the runs start from. + +With isolation off, every run is a plain session in the project folder. + +## Comparing results + +Each run is a normal session you can open, read, and keep or discard. If you started runs to compare approaches, review them side by side and carry the best one forward. + +If a single run fails to start, the others still launch — you'll just see fewer sessions than you asked for. + +## Related + +- [Worktree Sessions](/worktrees/) — how isolation works under the hood diff --git a/packages/docs/content/docs/notes-todos-plans.mdx b/packages/docs/content/docs/notes-todos-plans.mdx new file mode 100644 index 00000000..83307981 --- /dev/null +++ b/packages/docs/content/docs/notes-todos-plans.mdx @@ -0,0 +1,37 @@ +--- +title: Project Notes, Todos & Plans +description: Keep notes, a todo list, and saved plans for each project. +--- + +# Project Notes, Todos & Plans + +Each project has its own scratch space for notes, a todo list, and saved plans. They belong to the project, not to any one session, so they stick around as you move between sessions. Find them in the **Context** tab of the right sidebar (a dedicated tab on mobile). + +## Notes + +A free-form notes box for anything you want to remember about the project. It saves on its own as you type. + +## Todos + +A simple checklist. Add items, check them off, reorder them by dragging, and clear the finished ones. + +Each todo has a **send** menu so you can hand it to the agent: + +- send it to the current session +- start a new session with it +- start a new [worktree session](/worktrees/) with it (only when the project is a git repo) + +## Plans + +A place to keep longer plans as saved files. You can: + +- import a plan from a Markdown or text file +- open a plan to read it in the side panel +- delete plans you no longer need + +You should land back in the Context tab with your note saved, your todo checked, or your plan listed — that's how you know it took. + +## Related + +- [Worktree Sessions](/worktrees/) — run a todo in its own branch +- [Projects](/projects/) — these belong to the active project diff --git a/packages/docs/content/docs/notifications.mdx b/packages/docs/content/docs/notifications.mdx new file mode 100644 index 00000000..c888d9e7 --- /dev/null +++ b/packages/docs/content/docs/notifications.mdx @@ -0,0 +1,34 @@ +--- +title: Notifications +description: Get told when a session needs you or finishes. +--- + +# Notifications + +Notifications tell you when something needs your attention so you don't have to watch the screen — a session finished, hit an error, asked a question, or needs permission to do something. Set them up at **Settings → OpenChamber → Notifications**. + +## Turn them on + +1. Open **Settings → OpenChamber → Notifications**. +2. Allow notifications when your browser or system asks. +3. Choose what you want to be told about: + - a session **finishes** + - a session hits an **error** + - a session **asks a question** + - a session needs **permission** + - **subtasks** complete + +## How they reach you + +- on **desktop**, you get native system notifications +- in a **browser or installed app**, you get web push notifications, so they arrive even when the tab is in the background + +Sessions set to auto-accept won't nag you with permission notifications. + +## Customize the wording + +Each kind of notification has a title and message template you can edit, using fields like the agent name and model. There's also a limit on how much of the last message is included, so notifications stay short. + +## Related + +- [Voice Mode](/voice/) — hear replies read aloud instead diff --git a/packages/docs/content/docs/opencode-server.mdx b/packages/docs/content/docs/opencode-server.mdx new file mode 100644 index 00000000..2ee9680d --- /dev/null +++ b/packages/docs/content/docs/opencode-server.mdx @@ -0,0 +1,54 @@ +--- +title: OpenCode Server +description: Connect OpenChamber to a local or remote OpenCode server. +--- + +# OpenCode Server + +OpenChamber runs on top of an OpenCode server. By default it starts one for you, so you don't have to do anything. You only need this page if you want to point OpenChamber at a server you already run, or manage the one it starts. + +## How OpenChamber finds a server + +When OpenChamber starts, it looks for a server in this order: + +1. reuse a server it already started +2. connect to an external one if you told it to (see below) +3. auto-detect a server on the default port (`4096`) +4. otherwise, start and manage its own + +If nothing is configured, step 4 happens automatically and you're up and running. + +## Connect to a server you already run + +Set these before starting OpenChamber: + +```bash +OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber +``` + +- `OPENCODE_HOST` — the full address of your OpenCode server, including the port (a value like `http://localhost:4096`). It must not have a path at the end. +- `OPENCODE_SKIP_START=true` — tells OpenChamber not to start its own server. + +If you only need to change the port, set `OPENCODE_PORT` instead of `OPENCODE_HOST`. + +If `OPENCODE_HOST` is missing its port or has a path, OpenChamber ignores it and falls back to starting its own server. Watch the startup logs for a `[config]` warning if a connection you expected didn't happen. + +## Manage the server from the CLI + +```bash +openchamber status +openchamber logs +openchamber restart +openchamber stop +``` + +`openchamber` on its own starts the server in the background. Add `--foreground` to keep it attached to your terminal. + +## "OpenCode is restarting" + +While the server is starting or restarting, OpenChamber shows an "OpenCode is restarting" state and pauses requests until it's ready. This is normal right after launch or a restart. If it never clears, see [OpenCode connection](/troubleshooting/opencode-connection/). + +## Related + +- [Providers, Models & Agents](/providers/) — set up what the server talks to +- [OpenCode connection](/troubleshooting/opencode-connection/) — if it won't connect diff --git a/packages/docs/content/docs/pl/commands-snippets.mdx b/packages/docs/content/docs/pl/commands-snippets.mdx new file mode 100644 index 00000000..2cb82dc1 --- /dev/null +++ b/packages/docs/content/docs/pl/commands-snippets.mdx @@ -0,0 +1,39 @@ +--- +title: Polecenia i fragmenty +description: Twórz wielokrotnego użytku polecenia z ukośnikiem i fragmenty tekstu do czatu. +--- + +# Polecenia i fragmenty + +Polecenia i fragmenty oszczędzają Ci ponownego wpisywania tego samego. Polecenia to całe prompty uruchamiane przez `/`; fragmenty to kawałki tekstu wstawiane do wiadomości przez `#`. + +## Polecenia + +Polecenie to zapisany prompt uruchamiany ukośnikiem, jak `/review`. Zarządzaj nimi w **Settings → Commands**. + +1. Otwórz **Settings → Commands** i utwórz polecenie. +2. Nadaj mu nazwę, opis i tekst promptu, który ma wysłać. +3. Opcjonalnie przypnij je do konkretnego agenta lub modelu. +4. Wybierz zakres osobisty lub projektowy. + +W czacie wpisz `/` jako **pierwszy** znak wiadomości, aby otworzyć polecenia, a następnie wybierz jedno. Twój tekst może używać symboli zastępczych: + +- `$ARGUMENTS` — to, co wpiszesz po poleceniu +- `@filename` — wstawia zawartość pliku +- `` !`command` `` — wstawia wynik polecenia powłoki + +Wbudowane polecenia `init` i `review` można zresetować, ale nie usunąć. + +## Fragmenty + +Fragment to wielokrotnego użytku tekst, do którego odwołujesz się w treści hasztagiem, jak `#signoff`. Zarządzaj nimi w **Settings → Snippets**. + +1. Otwórz **Settings → Snippets** i utwórz fragment. +2. Nadaj mu nazwę i tekst, który reprezentuje. Dodaj aliasy, jeśli chcesz mieć więcej niż jeden wyzwalacz. +3. Wybierz zakres osobisty lub projektowy. + +W czacie wpisz `#` i wybierz fragment. OpenChamber podstawi pełny tekst przed wysłaniem. + +## Powiązane + +- [Skille](/pl/skills/) — wczytuj większe zestawy instrukcji na żądanie diff --git a/packages/docs/content/docs/pl/context.mdx b/packages/docs/content/docs/pl/context.mdx new file mode 100644 index 00000000..af185075 --- /dev/null +++ b/packages/docs/content/docs/pl/context.mdx @@ -0,0 +1,38 @@ +--- +title: Kontekst +description: Zobacz, ile pamięci modelu zużywa sesja. +--- + +# Kontekst + +Każdy model może pomieścić naraz tylko określoną część rozmowy — swój kontekst. OpenChamber pokazuje, jak bardzo jest on zapełniony, dzięki czemu widzisz, kiedy sesja zbliża się do limitu i odpowiedź może zacząć pomijać starsze szczegóły. + +## Szybki wskaźnik + +Podczas czatu mały wskaźnik pokazuje procent wykorzystanego kontekstu. Zmienia kolor w miarę zapełniania: + +- zielony — dużo miejsca +- żółty — coraz pełniej (około trzech czwartych) +- czerwony — niemal pełny + +Najedź na niego (lub stuknij na telefonie), aby zobaczyć dokładną liczbę tokenów. + +## Pełny panel kontekstu + +Otwórz zakładkę **Context** w prawym pasku bocznym, aby zobaczyć pełniejszy obraz bieżącej sesji: + +- używany model i kiedy sesja się rozpoczęła +- łączna liczba tokenów względem limitu modelu +- sumy wiadomości i kosztów +- podział tokenów ostatniej odpowiedzi +- przybliżony podział tego, co zajmuje kontekst (Twoje wiadomości, agenta, wynik narzędzi) + +Podział jest szacunkiem, a nie dokładnym wyliczeniem — używaj go do wykrycia, co zapełnia okno, a nie do rozliczeń. + +## Co zrobić, gdy jest pełny + +Rozpocznij świeżą sesję dla nowego zadania, zamiast pozwalać jednej sesji rosnąć w nieskończoność. Krótszy kontekst jest szybszy i utrzymuje model skupionym. + +## Powiązane + +- [Projekty](/pl/projects/) — sesje są grupowane według projektu diff --git a/packages/docs/content/docs/pl/desktop-browser.mdx b/packages/docs/content/docs/pl/desktop-browser.mdx new file mode 100644 index 00000000..194de0b6 --- /dev/null +++ b/packages/docs/content/docs/pl/desktop-browser.mdx @@ -0,0 +1,22 @@ +--- +title: Przeglądarka na komputerze +description: Przeglądaj dowolną stronę wewnątrz aplikacji na komputerze, z inspekcją i przechwytywaniem konsoli. +--- + +# Przeglądarka na komputerze + +Aplikacja na komputerze ma wbudowaną przeglądarkę, dzięki czemu możesz otworzyć dowolną stronę tuż obok czatu, wskazywać elementy, aby o nie zapytać, oraz przechwytywać konsolę strony. Otwórz ją z przycisku globusa w nagłówku aplikacji. + +> Przeglądarka na komputerze to funkcja **tylko na komputerze**. W wersji webowej panel [podglądu](/pl/preview/) oferuje te same narzędzia inspekcji i konsoli dla Twojego lokalnego serwera deweloperskiego. + +## Inspekcja i adnotacje + +Włącz **inspect** i kliknij dowolny element na stronie. OpenChamber przechwytuje o nim notatkę — czym jest, jakie ma style, gdzie się znajduje, oraz zrzut ekranu — i dołącza ją do Twojej wiadomości czatu. To najszybszy sposób, by powiedzieć agentowi „ten element, dokładnie tutaj”. + +## Przechwytywanie konsoli + +Przeglądarka zbiera wynik konsoli strony — błędy, ostrzeżenia i logi — dzięki czemu możesz go filtrować i czytać bez otwierania narzędzi deweloperskich. + +## Powiązane + +- [Podgląd i serwery deweloperskie](/pl/preview/) — te same narzędzia dla Twojego lokalnego serwera deweloperskiego diff --git a/packages/docs/content/docs/pl/git-identities.mdx b/packages/docs/content/docs/pl/git-identities.mdx new file mode 100644 index 00000000..03a6cd84 --- /dev/null +++ b/packages/docs/content/docs/pl/git-identities.mdx @@ -0,0 +1,30 @@ +--- +title: Tożsamości Git +description: Commituj z właściwym imieniem i adresem e-mail dla każdego repozytorium. +--- + +# Tożsamości Git + +Tożsamość git to imię i adres e-mail, którymi podpisywane są Twoje commity. Jeśli pracujesz z repozytoriami osobistymi i służbowymi, możesz zapisać tożsamości i zastosować właściwą dla każdego repozytorium, zamiast polegać na jednym globalnym ustawieniu. Zarządzaj nimi w **Settings → Git**. + +## Dodaj tożsamość + +1. Otwórz **Settings → Git** i wybierz **New**. +2. Wprowadź **name** i **email**, którymi chcesz commitować. +3. Wybierz, jak uwierzytelnia się ze zdalnym repozytorium: + - **SSH** — wskaż klucz SSH + - **token** — użyj zapisanego poświadczenia dla hosta +4. Opcjonalnie nadaj jej kolor i ikonę, by łatwo było ją rozpoznać. + +Globalna tożsamość Twojego systemu również jest pokazana, tylko do odczytu. + +## Zastosuj tożsamość do repozytorium + +Zastosowanie tożsamości zapisuje ją do **lokalnej** konfiguracji git tego repozytorium — wpływa tylko na to repozytorium, a nie na Twoje ustawienie globalne. Tożsamości SSH ustawiają też polecenie SSH, aby używać Twojego klucza; tożsamości tokenowe konfigurują przechowywanie poświadczeń dla hosta. + +Możesz zaimportować tożsamości, które OpenChamber wykryje w Twoich istniejących poświadczeniach git, i zapisać je jako tożsamości tokenowe. + +## Powiązane + +- [Przepływy Git i GitHub](/pl/git/) — commituj, używając ustawionej tożsamości +- [Issues i PR na GitHub](/pl/github/) — połącz konto GitHub na potrzeby PR-ów diff --git a/packages/docs/content/docs/pl/git.mdx b/packages/docs/content/docs/pl/git.mdx new file mode 100644 index 00000000..f7a46928 --- /dev/null +++ b/packages/docs/content/docs/pl/git.mdx @@ -0,0 +1,41 @@ +--- +title: Przepływy Git i GitHub +description: Dodawaj do indeksu, commituj i zarządzaj gałęziami bez wychodzenia z OpenChamber. +--- + +# Przepływy Git i GitHub + +OpenChamber ma wbudowany widok git, dzięki czemu możesz przeglądać zmiany, commitować i zarządzać gałęziami bez przełączania się na terminal. Otwórz go z zakładki **Git** w prawym pasku bocznym. + +## Przeglądaj i commituj + +Widok git dzieli Twoje zmiany na **staged** i **unstaged**: + +- kliknij **+** przy pliku, aby dodać go do indeksu, lub **−**, aby go usunąć z indeksu +- dodaj lub usuń z indeksu wszystko w grupie naraz +- kliknij plik, aby zobaczyć jego diff + +Następnie napisz komunikat commita i commituj. Możesz zlecić OpenChamber **wygenerowanie komunikatu commita** na podstawie Twoich zmian z indeksu — używa modelu bieżącej sesji, więc potrzebujesz otwartej sesji. + +## Gałęzie i historia + +Widok git obejmuje też resztę codziennej pracy z git: + +- twórz, przełączaj, zmieniaj nazwy i usuwaj gałęzie +- push, pull i fetch +- przeglądaj historię i diffy poszczególnych commitów +- odkładaj (stash) i przywracaj zmiany + +## Pull requesty + +Połącz GitHub (zobacz [Issues i PR na GitHub](/pl/github/)), a zakładka **PR** pozwoli Ci otworzyć pull request, zaktualizować go, oznaczyć jako gotowy lub scalić — oraz wygenerować jego tytuł i opis w ten sam sposób co komunikaty commitów. + +## Rozwiązywanie konfliktów + +Jeśli scalanie, rebase lub integracja napotka konflikt, OpenChamber pokazuje, co utknęło, i pozwala Ci to rozwiązać — w tym przekazać to agentowi. + +## Powiązane + +- [Issues i PR na GitHub](/pl/github/) — połącz GitHub i rozpocznij pracę od issue +- [Sesje worktree](/pl/worktrees/) — izoluj gałąź w jej własnym folderze +- [Tożsamości Git](/pl/git-identities/) — commituj jako właściwa osoba w każdym repozytorium diff --git a/packages/docs/content/docs/pl/github.mdx b/packages/docs/content/docs/pl/github.mdx new file mode 100644 index 00000000..5d56001c --- /dev/null +++ b/packages/docs/content/docs/pl/github.mdx @@ -0,0 +1,34 @@ +--- +title: Issues i PR na GitHub +description: Połącz GitHub i rozpoczynaj sesje od issues i pull requestów. +--- + +# Issues i PR na GitHub + +Połącz swoje konto GitHub, a OpenChamber może pobierać issues i pull requesty, rozpocząć sesję bezpośrednio z jednego z nich oraz otwierać lub aktualizować za Ciebie PR-y. + +## Połącz GitHub + +1. Otwórz **Settings → Git**. +2. W sekcji GitHub wybierz **Connect**. OpenChamber pokazuje link i krótki kod. +3. Otwórz link, wpisz kod i zatwierdź. + +Po połączeniu Twoje konto pojawia się w sekcji GitHub. Możesz połączyć więcej niż jedno konto i przełączać się między nimi albo rozłączyć w dowolnym momencie. + +## Rozpocznij pracę od issue lub PR + +Gdy tworzysz [sesję worktree](/pl/worktrees/) z połączonym GitHub, możesz wybrać **Start from GitHub issue/PR**: + +- wybierz **issue**, a OpenChamber nazwie gałąź jego nazwą i otworzy sesję z issue oraz jego komentarzami jako pierwszą wiadomością +- wybierz **pull request**, a wyewidencjonuje on gałąź PR; możesz dołączyć diff PR, aby agent miał całą zmianę + +To wprowadza Cię prosto do sesji z już wczytanym kontekstem. + +## Otwieraj pull requesty i nimi zarządzaj + +Z zakładki **PR** w [widoku git](/pl/git/) możesz utworzyć pull request, zaktualizować go, oznaczyć szkic jako gotowy lub scalić go. OpenChamber może wygenerować tytuł i opis PR na podstawie Twoich zmian. + +## Powiązane + +- [Przepływy Git i GitHub](/pl/git/) — commituj i zarządzaj gałęziami +- [Sesje worktree](/pl/worktrees/) — gdzie startują sesje issue i PR diff --git a/packages/docs/content/docs/pl/index.mdx b/packages/docs/content/docs/pl/index.mdx index 1ed9a8fd..bb163749 100644 --- a/packages/docs/content/docs/pl/index.mdx +++ b/packages/docs/content/docs/pl/index.mdx @@ -20,6 +20,13 @@ Skorzystaj z tej dokumentacji, aby: - [Tunele](/pl/tunnels/) - [Rozwiązywanie problemów](/pl/troubleshooting/) +## Odkryj więcej + +- [Projekty](/pl/projects/) i [Sesje worktree](/pl/worktrees/) — organizuj i izoluj swoją pracę +- [Dostawcy, modele i agenci](/pl/providers/) — połącz OpenCode i wybierz model +- [Przepływy Git i GitHub](/pl/git/) — twórz commity, przeglądaj i otwieraj PR-y +- [Bezpieczeństwo](/pl/security/) i [Tunele](/pl/tunnels/) — chroń swoją instancję i uzyskuj do niej dostęp + ## Do czego służy OpenChamber OpenChamber jest przeznaczony do tych części programowania z AI, które zyskują na centrum dowodzenia: rozgałęzianie sesji, przeglądanie diffów, zarządzanie terminalami, śledzenie postępu narzędzi, uruchamianie akcji projektu i utrzymywanie całej planszy na widoku, gdy agent pracuje. diff --git a/packages/docs/content/docs/pl/magic-prompts.mdx b/packages/docs/content/docs/pl/magic-prompts.mdx new file mode 100644 index 00000000..c54be855 --- /dev/null +++ b/packages/docs/content/docs/pl/magic-prompts.mdx @@ -0,0 +1,26 @@ +--- +title: Magic Prompts +description: Dostosuj wbudowane prompty stojące za automatycznymi przepływami OpenChamber. +--- + +# Magic Prompts + +OpenChamber używa w tle wbudowanych promptów za każdym razem, gdy robi coś automatycznie — pisze komunikat commita, szkicuje PR, przegląda issue, rozwiązuje konflikt, podsumowuje sesję. Magic Prompts to miejsce, w którym czytasz i przepisujesz te prompty. Otwórz je w **Settings → Magic Prompts**. + +Do normalnego użytku ta strona nie jest potrzebna. Sięgnij po nią, gdy chcesz, by przepływ zachowywał się inaczej — powiedzmy komunikaty commitów w określonym stylu. + +## Edytuj prompt + +1. Otwórz **Settings → Magic Prompts**. +2. Wybierz prompt z grup w pasku bocznym — Git, GitHub, Planning i Session. +3. Edytuj tekst i zapisz. + +Niektóre prompty mają część widoczną (wiadomość, którą zobaczysz) i część z instrukcjami (ukryte wskazówki dla agenta). Prompty mogą zawierać `{{placeholders}}`, które OpenChamber uzupełnia, jak diff czy tytuł issue — zostaw je na miejscu. + +## Reset + +Zmieniłeś zdanie? Każdy prompt ma **reset to default**, a jest też **reset all**, jeśli chcesz zacząć wszystko od nowa. + +## Powiązane + +- [Przepływy Git i GitHub](/pl/git/) — wiele z tych promptów napędza przepływy git diff --git a/packages/docs/content/docs/pl/mcp.mdx b/packages/docs/content/docs/pl/mcp.mdx new file mode 100644 index 00000000..0322b93a --- /dev/null +++ b/packages/docs/content/docs/pl/mcp.mdx @@ -0,0 +1,30 @@ +--- +title: Serwery MCP +description: Dodawaj serwery MCP, aby dać agentom dodatkowe narzędzia. +--- + +# Serwery MCP + +Serwer MCP daje Twoim agentom dodatkowe narzędzia — takie jak przeszukiwanie bazy danych, wywoływanie API czy odczytywanie używanej przez Ciebie usługi. Dodaj je w **Settings → MCP**. + +## Dodaj serwer + +1. Otwórz **Settings → MCP**. +2. Dodaj serwer i wybierz jego typ: + - **local** — OpenChamber uruchamia polecenie na Twojej maszynie. Podajesz polecenie do uruchomienia oraz, w razie potrzeby, zmienne środowiskowe. + - **remote** — OpenChamber łączy się z adresem URL hostowanym przez kogoś innego. Podajesz adres URL oraz wszelkie potrzebne nagłówki (na przykład token uwierzytelniający). +3. Zapisz. Serwer jest domyślnie włączony; możesz go wyłączyć bez usuwania. + +## Gdzie obowiązuje + +Wybierz zakres przy dodawaniu serwera: + +- **personal** — dostępny w każdym projekcie +- **project** — dostępny tylko w bieżącym projekcie i zapisany razem z pozostałymi ustawieniami projektu + +Nazwy serwerów używają małych liter, cyfr, myślników i podkreśleń. + +## Powiązane + +- [Dostawcy, modele i agenci](/pl/providers/) — najpierw połącz model +- [Skille](/pl/skills/) — inny sposób na rozszerzenie możliwości agentów diff --git a/packages/docs/content/docs/pl/mobile.mdx b/packages/docs/content/docs/pl/mobile.mdx new file mode 100644 index 00000000..9c9bd1c8 --- /dev/null +++ b/packages/docs/content/docs/pl/mobile.mdx @@ -0,0 +1,31 @@ +--- +title: PWA i dostęp z telefonu +description: Zainstaluj OpenChamber jako aplikację i używaj go z telefonu. +--- + +# PWA i dostęp z telefonu + +Aplikacja webowa OpenChamber instaluje się jak aplikacja na telefonie (PWA), więc możesz trzymać ją na ekranie głównym i używać jej na pełnym ekranie. Połącz to z [tunelem](/pl/tunnels/), a będziesz mógł zajrzeć do sesji z dowolnego miejsca. + +## Zainstaluj ją + +OpenChamber korzysta z wbudowanej instalacji Twojej przeglądarki, więc nie ma osobnego pobierania: + +- **przeglądarka na komputerze** — użyj opcji **Install** w pasku adresu +- **iPhone/iPad (Safari)** — Udostępnij → **Dodaj do ekranu początkowego** +- **Android (Chrome)** — menu → **Zainstaluj aplikację** / **Dodaj do ekranu głównego** + +Po zainstalowaniu otwiera się we własnym oknie, bez elementów przeglądarki. + +## Dotrzyj do niej z telefonu + +Aby otworzyć OpenChamber na telefonie, gdy serwer działa na Twoim komputerze, uruchom [tunel](/pl/tunnels/) i otwórz link (lub zeskanuj kod QR) na telefonie. Używaj silnego [hasła UI](/pl/security/), gdy tylko to robisz. + +## Ustawienia mobilne + +W **Settings → OpenChamber** kilka opcji dostraja działanie na telefonie i zainstalowanej aplikacji — nazwę zainstalowanej aplikacji, orientację ekranu i zachowanie klawiatury ekranowej. + +## Powiązane + +- [Tunele](/pl/tunnels/) — dotrzyj do swojej instancji z innej sieci +- [Bezpieczeństwo](/pl/security/) — zabezpiecz UI przed udostępnieniem diff --git a/packages/docs/content/docs/pl/multi-run.mdx b/packages/docs/content/docs/pl/multi-run.mdx new file mode 100644 index 00000000..4a457c61 --- /dev/null +++ b/packages/docs/content/docs/pl/multi-run.mdx @@ -0,0 +1,32 @@ +--- +title: Multi-run +description: Uruchom ten sam prompt na kilku modelach lub w kilku sesjach naraz. +--- + +# Multi-run + +Multi-run uruchamia kilka sesji z jednego formularza — przydatne do wypróbowania tego samego zadania na różnych modelach i porównania wyników. Otwórz go z przycisku u góry paska bocznego sesji. + +## Rozpocznij multi-run + +1. Otwórz launcher multi-run. +2. Wybierz projekt i nazwij grupę uruchomień. +3. Napisz prompt i wybierz modele, na których ma się uruchomić (do pięciu na grupę). +4. Wybierz, czy **isolate runs**. +5. Uruchom. + +Każdy model dostaje własną sesję i wszystkie startują z Twoim promptem. + +## Izolowane uruchomienia + +Włącz **isolate runs**, aby każde uruchomienie miało własny [worktree](/pl/worktrees/) i gałąź, dzięki czemu nigdy nie dotykają tych samych plików. Wymaga to repozytorium git — dla folderów, które nim nie są, jest automatycznie wyłączone. Wybierz gałąź, od której startują uruchomienia. + +Gdy izolacja jest wyłączona, każde uruchomienie jest zwykłą sesją w folderze projektu. + +## Porównywanie wyników + +Każde uruchomienie to zwykła sesja, którą możesz otworzyć, przeczytać i zachować lub odrzucić. Jeśli uruchomiłeś sesje, aby porównać podejścia, przejrzyj je obok siebie i przenieś najlepsze dalej. + +## Powiązane + +- [Sesje worktree](/pl/worktrees/) — jak izolacja działa pod spodem diff --git a/packages/docs/content/docs/pl/notes-todos-plans.mdx b/packages/docs/content/docs/pl/notes-todos-plans.mdx new file mode 100644 index 00000000..04fee870 --- /dev/null +++ b/packages/docs/content/docs/pl/notes-todos-plans.mdx @@ -0,0 +1,37 @@ +--- +title: Notatki, listy zadań i plany projektu +description: Prowadź notatki, listę zadań i zapisane plany dla każdego projektu. +--- + +# Notatki, listy zadań i plany projektu + +Każdy projekt ma własną przestrzeń roboczą na notatki, listę zadań i zapisane plany. Należą do projektu, a nie do żadnej pojedynczej sesji, więc pozostają na miejscu, gdy przechodzisz między sesjami. Znajdziesz je w zakładce **Context** prawego paska bocznego (na telefonie dedykowana zakładka). + +## Notatki + +Dowolne pole na notatki o wszystkim, co chcesz zapamiętać na temat projektu. Zapisuje się samo w trakcie pisania. + +## Listy zadań + +Prosta lista kontrolna. Dodawaj pozycje, odhaczaj je, zmieniaj kolejność przeciąganiem i czyść ukończone. + +Każde zadanie ma menu **send**, dzięki któremu możesz przekazać je agentowi: + +- wyślij je do bieżącej sesji +- rozpocznij z nim nową sesję +- rozpocznij z nim nową [sesję worktree](/pl/worktrees/) (tylko gdy projekt jest repozytorium git) + +## Plany + +Miejsce na przechowywanie dłuższych planów jako zapisanych plików. Możesz: + +- zaimportować plan z pliku Markdown lub tekstowego +- otworzyć plan, aby przeczytać go w panelu bocznym +- usunąć plany, których już nie potrzebujesz + +Powinieneś wrócić do zakładki Context z zapisaną notatką, odhaczonym zadaniem lub wylistowanym planem — tak poznasz, że się udało. + +## Powiązane + +- [Sesje worktree](/pl/worktrees/) — uruchom zadanie w jego własnej gałęzi +- [Projekty](/pl/projects/) — należą one do aktywnego projektu diff --git a/packages/docs/content/docs/pl/notifications.mdx b/packages/docs/content/docs/pl/notifications.mdx new file mode 100644 index 00000000..0e91194a --- /dev/null +++ b/packages/docs/content/docs/pl/notifications.mdx @@ -0,0 +1,34 @@ +--- +title: Powiadomienia +description: Otrzymuj powiadomienia, gdy sesja Cię potrzebuje lub kończy pracę. +--- + +# Powiadomienia + +Powiadomienia informują Cię, gdy coś wymaga Twojej uwagi, dzięki czemu nie musisz wpatrywać się w ekran — sesja się zakończyła, napotkała błąd, zadała pytanie albo potrzebuje uprawnień do zrobienia czegoś. Skonfiguruj je w **Settings → OpenChamber → Notifications**. + +## Włącz je + +1. Otwórz **Settings → OpenChamber → Notifications**. +2. Zezwól na powiadomienia, gdy przeglądarka lub system o to poprosi. +3. Wybierz, o czym chcesz być informowany: + - sesja się **kończy** + - sesja napotyka **błąd** + - sesja **zadaje pytanie** + - sesja potrzebuje **uprawnień** + - **podzadania** się kończą + +## Jak do Ciebie docierają + +- na **komputerze** otrzymujesz natywne powiadomienia systemowe +- w **przeglądarce lub zainstalowanej aplikacji** otrzymujesz powiadomienia web push, więc docierają nawet wtedy, gdy karta jest w tle + +Sesje ustawione na automatyczną akceptację nie będą Cię nagabywać powiadomieniami o uprawnieniach. + +## Dostosuj treść + +Każdy rodzaj powiadomienia ma szablon tytułu i wiadomości, który możesz edytować, używając pól takich jak nazwa agenta i model. Jest też limit tego, ile z ostatniej wiadomości zostaje dołączone, aby powiadomienia pozostały krótkie. + +## Powiązane + +- [Tryb głosowy](/pl/voice/) — zamiast tego słuchaj odczytywanych odpowiedzi diff --git a/packages/docs/content/docs/pl/opencode-server.mdx b/packages/docs/content/docs/pl/opencode-server.mdx new file mode 100644 index 00000000..2667a00b --- /dev/null +++ b/packages/docs/content/docs/pl/opencode-server.mdx @@ -0,0 +1,54 @@ +--- +title: OpenCode Server +description: Połącz OpenChamber z lokalnym lub zdalnym serwerem OpenCode. +--- + +# OpenCode Server + +OpenChamber działa na bazie serwera OpenCode. Domyślnie uruchamia go za Ciebie, więc nie musisz robić nic dodatkowego. Ta strona jest potrzebna tylko wtedy, gdy chcesz wskazać OpenChamber serwer, który już uruchamiasz, albo zarządzać tym, który sam startuje. + +## Jak OpenChamber znajduje serwer + +Gdy OpenChamber się uruchamia, szuka serwera w tej kolejności: + +1. ponownie używa serwera, który już uruchomił +2. łączy się z zewnętrznym, jeśli mu to wskazałeś (zobacz niżej) +3. automatycznie wykrywa serwer na domyślnym porcie (`4096`) +4. w przeciwnym razie uruchamia i obsługuje własny + +Jeśli nic nie jest skonfigurowane, krok 4 dzieje się automatycznie i od razu możesz pracować. + +## Połącz się z serwerem, który już uruchamiasz + +Ustaw te wartości przed uruchomieniem OpenChamber: + +```bash +OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber +``` + +- `OPENCODE_HOST` — pełny adres Twojego serwera OpenCode, wraz z portem (wartość taka jak `http://localhost:4096`). Nie może zawierać ścieżki na końcu. +- `OPENCODE_SKIP_START=true` — informuje OpenChamber, aby nie uruchamiał własnego serwera. + +Jeśli chcesz zmienić tylko port, ustaw `OPENCODE_PORT` zamiast `OPENCODE_HOST`. + +Jeśli w `OPENCODE_HOST` brakuje portu lub zawiera ścieżkę, OpenChamber go zignoruje i wróci do uruchamiania własnego serwera. Obserwuj logi startowe pod kątem ostrzeżenia `[config]`, jeśli oczekiwane połączenie nie nastąpiło. + +## Zarządzaj serwerem z poziomu CLI + +```bash +openchamber status +openchamber logs +openchamber restart +openchamber stop +``` + +Samo `openchamber` uruchamia serwer w tle. Dodaj `--foreground`, aby pozostał dołączony do Twojego terminala. + +## „OpenCode uruchamia się ponownie” + +Gdy serwer startuje lub uruchamia się ponownie, OpenChamber pokazuje stan „OpenCode uruchamia się ponownie” i wstrzymuje żądania, aż będzie gotowy. To normalne tuż po uruchomieniu lub restarcie. Jeśli ten stan nigdy nie znika, zobacz [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/). + +## Powiązane + +- [Dostawcy, modele i agenci](/pl/providers/) — skonfiguruj to, z czym serwer się komunikuje +- [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/) — jeśli nie chce się połączyć diff --git a/packages/docs/content/docs/pl/preview.mdx b/packages/docs/content/docs/pl/preview.mdx new file mode 100644 index 00000000..7a5519b5 --- /dev/null +++ b/packages/docs/content/docs/pl/preview.mdx @@ -0,0 +1,32 @@ +--- +title: Podgląd i serwery deweloperskie +description: Otwórz działający serwer deweloperski wewnątrz OpenChamber. +--- + +# Podgląd i serwery deweloperskie + +Gdy uruchamiasz serwer deweloperski, OpenChamber może otworzyć go bezpośrednio w aplikacji zamiast w osobnej karcie przeglądarki — dzięki czemu widzisz swoją witrynę obok czatu, przechwytujesz jej konsolę i wskazujesz elementy, aby o nie zapytać. + +## Otwórz podgląd + +OpenChamber obserwuje wynik terminala pod kątem adresu lokalnego (wiersz `Local:`, który drukują narzędzia takie jak Vite, Next.js czy Astro). Gdy go wykryje: + +- w terminalu pojawia się przycisk **Open preview** +- [akcja projektu](/pl/project-actions/) z włączonym auto-open otwiera go za Ciebie +- lokalny link w wiadomości czatu również może go otworzyć + +Witryna ładuje się w panelu bocznym. Podglądać można wyłącznie adresy lokalne (na Twojej własnej maszynie). + +## Konsola i inspekcja + +W panelu podglądu możesz: + +- obserwować **konsolę** strony — błędy, ostrzeżenia i logi, filtrowane wedle uznania +- włączyć **inspect**, kliknąć dowolny element i wysłać o nim notatkę — selektor, style, pozycję i zrzut ekranu — prosto do czatu + +To najszybszy sposób, by powiedzieć agentowi „ten przycisk, tutaj”, bez opisywania go. + +## Powiązane + +- [Akcje projektu](/pl/project-actions/) — automatycznie otwórz serwer przy uruchomieniu +- [Przeglądarka na komputerze](/pl/desktop-browser/) — te same narzędzia dla dowolnej strony, na komputerze diff --git a/packages/docs/content/docs/pl/project-actions.mdx b/packages/docs/content/docs/pl/project-actions.mdx new file mode 100644 index 00000000..780efc5b --- /dev/null +++ b/packages/docs/content/docs/pl/project-actions.mdx @@ -0,0 +1,28 @@ +--- +title: Akcje projektu +description: Zapisuj często uruchamiane polecenia i uruchamiaj je jednym kliknięciem. +--- + +# Akcje projektu + +Akcja projektu to polecenie powłoki, które zapisujesz raz i uruchamiasz kliknięciem — serwer deweloperski, build, uruchomienie testów. Każdy projekt ma własną listę. Skonfiguruj je w **Settings → Projects → Project Actions**. + +## Dodaj akcję + +1. Otwórz **Settings → Projects** i znajdź sekcję **Project Actions**. +2. Dodaj akcję, nadaj jej nazwę, wybierz ikonę i wprowadź polecenie do uruchomienia. +3. Zapisz. + +Akcję możesz ograniczyć do określonych systemów operacyjnych, jeśli polecenie ma sens tylko na jednym z nich. + +## Uruchom akcję + +Akcje znajdują się w menu w nagłówku aplikacji. Kliknij jedną, a OpenChamber uruchomi ją w terminalu w folderze Twojego projektu, przełączając Cię na widok terminala, byś mógł obserwować wynik. Zatrzymaj ją z tego samego menu. + +## Automatyczne otwieranie serwera deweloperskiego + +Włącz **auto-open URL** dla akcji, która uruchamia serwer. OpenChamber obserwuje wynik pod kątem adresu lokalnego i proponuje jego otwarcie — zobacz [Podgląd i serwery deweloperskie](/pl/preview/). Na komputerze możesz też przekierować go przez przekazywanie portu SSH. + +## Powiązane + +- [Podgląd i serwery deweloperskie](/pl/preview/) — otwórz działający serwer deweloperski wewnątrz OpenChamber diff --git a/packages/docs/content/docs/pl/project-icons.mdx b/packages/docs/content/docs/pl/project-icons.mdx new file mode 100644 index 00000000..798a1f73 --- /dev/null +++ b/packages/docs/content/docs/pl/project-icons.mdx @@ -0,0 +1,20 @@ +--- +title: Ikony projektów +description: Nadaj każdemu projektowi rozpoznawalną ikonę. +--- + +# Ikony projektów + +Ikona projektu ułatwia odróżnienie projektów na pierwszy rzut oka. OpenChamber próbuje znaleźć jedną za Ciebie, a Ty zawsze możesz ustawić własną. Zarządzaj nią w **Settings → Projects**. + +## Automatyczne wykrywanie + +Gdy dodajesz projekt, OpenChamber szuka w nim pliku `favicon` i używa go jako ikony projektu. Jeśli Twoje repozytorium już zawiera favicon, ikona zwykle po prostu się pojawia — nic nie trzeba robić. + +## Ustaw własną + +Otwórz **Settings → Projects** i prześlij obraz (PNG, JPEG lub SVG, do 5 MB). Własny obraz ma pierwszeństwo przed wykrytym automatycznie. Możesz też wybrać kolor albo usunąć obraz, aby wrócić do wykrywania. + +## Powiązane + +- [Projekty](/pl/projects/) — nazywaj, koloruj i organizuj swoje projekty diff --git a/packages/docs/content/docs/pl/projects.mdx b/packages/docs/content/docs/pl/projects.mdx new file mode 100644 index 00000000..cb941087 --- /dev/null +++ b/packages/docs/content/docs/pl/projects.mdx @@ -0,0 +1,34 @@ +--- +title: Projekty +description: Organizuj swoją pracę w projekty i przełączaj się między nimi. +--- + +# Projekty + +Projekt to folder na Twoim komputerze, który OpenChamber śledzi — zwykle jedna baza kodu. Przełączenie projektu zmienia folder, w którym pracuje agent, wraz z sesjami i ustawieniami tego projektu. + +## Dodaj projekt + +Projekt możesz dodać z kilku miejsc: + +- pozycja **Add project** w palecie poleceń +- przycisk **+** u góry paska bocznego sesji +- przeglądarka folderów, gdy wybierasz katalog + +Wskaż folder, a OpenChamber go zapamięta. Nazwa pochodzi od folderu; możesz ją później zmienić. + +## Przełączaj projekty + +Wybierz projekt z paska bocznego, aby go aktywować. Wszystko — sesje, git, notatki — podąża za otwartym projektem. + +## Spraw, by projekt był rozpoznawalny + +Otwórz **Settings → Projects**, aby nadać projektowi własną nazwę, kolor lub ikonę. OpenChamber próbuje znaleźć ikonę automatycznie — zobacz [Ikony projektów](/pl/project-icons/). + +> W VS Code OpenChamber zawsze używa otwartego folderu jako jedynego projektu, więc nie ma nic do dodawania ani przełączania. Strona ustawień Projects jest tam ukryta. + +## Powiązane + +- [Notatki, listy zadań i plany projektu](/pl/notes-todos-plans/) — prowadź robocze notatki dla każdego projektu +- [Akcje projektu](/pl/project-actions/) — zapisuj często uruchamiane polecenia +- [Kontekst](/pl/context/) — zobacz, ile pamięci modelu zużywa sesja diff --git a/packages/docs/content/docs/pl/providers.mdx b/packages/docs/content/docs/pl/providers.mdx new file mode 100644 index 00000000..8675b91a --- /dev/null +++ b/packages/docs/content/docs/pl/providers.mdx @@ -0,0 +1,49 @@ +--- +title: Dostawcy, modele i agenci +description: Połącz dostawców AI, wybierz modele i skonfiguruj agentów. +--- + +# Dostawcy, modele i agenci + +Zanim OpenChamber cokolwiek zrobi, potrzebuje co najmniej jednego połączonego dostawcy AI. Ta strona opisuje łączenie dostawcy, wybór modelu i dostosowywanie agentów. + +## Połącz dostawcę + +1. Otwórz **Settings → Providers**. +2. Otwórz menu **Add provider** i wybierz dostawcę, który nie jest jeszcze połączony. +3. Zaloguj się na jeden z dwóch sposobów, zależnie od dostawcy: + - **Klucz API** — wklej swój klucz i zapisz. + - **Logowanie (device flow)** — OpenChamber pokazuje link i krótki kod. Otwórz link, wpisz kod i zatwierdź. OpenChamber sam dokończy łączenie. + +Gdy dostawca pokazuje się jako połączony, jego modele stają się dostępne w czacie. + +Aby się rozłączyć, otwórz dostawcę i wybierz usunięcie jego logowania. + +## Wybierz model + +Model wybierasz tam, gdzie pracujesz: + +- w czacie użyj selektora modelu w pasku wiadomości, aby ustawić dostawcę i model dla tej sesji +- dla agenta ustaw model domyślny (poniżej) + +## Skonfiguruj agentów + +Agent to nazwana konfiguracja — model, osobowość i to, co wolno mu robić. + +1. Otwórz **Settings → Agents**. +2. Wybierz agenta lub utwórz nowego. +3. Edytuj dowolne z poniższych: + - **description** — do czego służy agent + - **model** — jego domyślny model + - **temperature** — jak kreatywne są jego odpowiedzi + - **prompt** — stałe instrukcje, których zawsze przestrzega + - **tool rules** — których narzędzi może używać + +## Gdzie są przechowywane Twoje logowania + +Logowania dostawców są przechowywane przez OpenCode, a nie OpenChamber, więc są współdzielone z OpenCode CLI. Jeśli ustawisz tego samego dostawcę w więcej niż jednym miejscu, wygrywa ustawienie najbardziej szczegółowe: ustawienie dla projektu nadpisuje Twoje osobiste. + +## Powiązane + +- [Serwery MCP](/pl/mcp/) — dodaj agentom dodatkowe narzędzia +- [Zużycie i limity](/pl/usage/) — śledź, ile już wykorzystałeś diff --git a/packages/docs/content/docs/pl/remote-instances.mdx b/packages/docs/content/docs/pl/remote-instances.mdx new file mode 100644 index 00000000..b026946b --- /dev/null +++ b/packages/docs/content/docs/pl/remote-instances.mdx @@ -0,0 +1,30 @@ +--- +title: Zdalne instancje +description: Połącz aplikację na komputerze z OpenChamber na innej maszynie przez SSH. +--- + +# Zdalne instancje + +Aplikacja na komputerze może połączyć się z OpenChamber działającym na innej maszynie przez SSH — serwer służbowy, maszyna w chmurze, homelab — i przenieść jego UI na Twój ekran, jakby był lokalny. Skonfiguruj to w **Settings → Remote Instances**. + +> Zdalne instancje to funkcja **tylko na komputerze**. W wersji webowej lub w VS Code połącz się ze zdalnym serwerem za pomocą zmiennych środowiskowych z [OpenCode Server](/pl/opencode-server/). + +## Dodaj zdalną instancję + +1. Otwórz **Settings → Remote Instances** i dodaj jedną. +2. Podaj polecenie SSH, którego normalnie używasz, by dotrzeć do maszyny, oraz przydomek. +3. Wybierz, jak OpenChamber tam działa: + - **managed** — OpenChamber instaluje i uruchamia się sam na zdalnej maszynie + - **external** — połącz się z tym, który już działa +4. Połącz. + +OpenChamber przeprowadza przez kolejne kroki — sprawdzenie połączenia, skonfigurowanie zdalnej maszyny, uruchomienie serwera i przekazanie portu — i pokazuje, na jakim etapie się znajduje. Gdy osiągnie stan **ready**, zdalne UI ładuje się lokalnie. + +## Poświadczenia + +Sam decydujesz, czy zapisać hasła SSH i UI, czy wpisywać je za każdym razem. Jeśli połączenie zostanie zerwane, OpenChamber zgłasza, który krok zawiódł, byś mógł to naprawić — zobacz [Dostęp zdalny](/pl/troubleshooting/remote-access/). + +## Powiązane + +- [OpenCode Server](/pl/opencode-server/) — połącz się ze zdalnym serwerem w wersji webowej lub VS Code +- [Dostęp zdalny](/pl/troubleshooting/remote-access/) — gdy połączenie nie chce się nawiązać diff --git a/packages/docs/content/docs/pl/scheduled-tasks.mdx b/packages/docs/content/docs/pl/scheduled-tasks.mdx new file mode 100644 index 00000000..842ab5e4 --- /dev/null +++ b/packages/docs/content/docs/pl/scheduled-tasks.mdx @@ -0,0 +1,33 @@ +--- +title: Zaplanowane zadania +description: Uruchamiaj prompt automatycznie według harmonogramu. +--- + +# Zaplanowane zadania + +Zaplanowane zadanie uruchamia za Ciebie prompt według harmonogramu — na przykład codzienne „podsumuj wczorajsze zmiany” albo cotygodniowe porządki. Gdy się uruchamia, OpenChamber rozpoczyna nową sesję i sam wysyła prompt. Otwórz harmonogram z przycisku u góry paska bocznego sesji. + +## Utwórz zadanie + +1. Otwórz okno zaplanowanych zadań z paska bocznego sesji. +2. Dodaj zadanie i nadaj mu nazwę. +3. Wybierz, kiedy się uruchamia: + - **daily** — o jednej lub kilku porach każdego dnia + - **weekly** — w wybrane dni tygodnia i godziny + - **once** — jedna data i godzina +4. Ustaw, co robi: prompt do wysłania oraz dostawcę, model i agenta do użycia. Promptem może być polecenie z ukośnikiem, jak `/review`. +5. Zapisz i upewnij się, że zadanie jest włączone. + +Dowolne zadanie możesz uruchomić natychmiast za pomocą **run now**, aby sprawdzić, czy robi to, czego oczekujesz. + +## Jak wygląda sukces + +Po uruchomieniu zadanie pokazuje, kiedy ostatnio się wykonało, czy się powiodło, oraz link do utworzonej sesji. Jeśli uruchomienie się nie powiedzie, błąd również jest tam pokazany. + +## Pamiętaj + +Zadania uruchamiają się tylko wtedy, gdy serwer OpenChamber działa. Jeśli go zamkniesz, zaplanowane uruchomienia są wstrzymane, dopóki nie wróci. + +## Powiązane + +- [Polecenia i fragmenty](/pl/commands-snippets/) — użyj ponownie polecenia z ukośnikiem jako promptu diff --git a/packages/docs/content/docs/pl/security.mdx b/packages/docs/content/docs/pl/security.mdx new file mode 100644 index 00000000..6be99d89 --- /dev/null +++ b/packages/docs/content/docs/pl/security.mdx @@ -0,0 +1,37 @@ +--- +title: Bezpieczeństwo +description: Zabezpiecz UI hasłem i kluczami dostępu, zanim je udostępnisz. +--- + +# Bezpieczeństwo + +OpenChamber daje dostęp do Twojej maszyny i Twojego kodu, więc zabezpiecz go, zanim ktokolwiek poza Tobą będzie mógł do niego dotrzeć. Ta strona omawia hasło UI, klucze dostępu (passkeys) oraz to, co warto wiedzieć przed udostępnieniem OpenChamber w sieci. + +## Ustaw hasło UI + +Uruchom OpenChamber z hasłem, a interfejs webowy poprosi o nie: + +```bash +openchamber --ui-password be-creative-here +``` + +Możesz też ustawić je za pomocą zmiennej środowiskowej `OPENCHAMBER_UI_PASSWORD`, zamiast podawać je w wierszu poleceń. Po zalogowaniu OpenChamber zapamiętuje urządzenie na pewien czas, więc nie pyta za każdym razem. + +Zawsze ustawiaj hasło, jeśli instancja jest dostępna dla kogokolwiek innego — zwłaszcza przez [tunel](/pl/tunnels/) lub publiczny internet. + +## Klucze dostępu (passkeys) + +Po ustawieniu hasła możesz dodać klucze dostępu (Face ID, Touch ID, klucz bezpieczeństwa) dla szybszego logowania. Dodaj je w **Settings → OpenChamber → Passkeys**. + +Klucze dostępu są powiązane z bieżącym hasłem. Jeśli zmienisz lub usuniesz hasło, zapisane klucze dostępu zostaną wyczyszczone i będziesz je dodawać ponownie. + +## Zanim ją udostępnisz + +- Domyślnie OpenChamber nasłuchuje tylko na Twojej własnej maszynie (`127.0.0.1`). Nasłuchiwanie szerzej wymaga celowej zmiany i najpierw powinieneś ustawić hasło. +- Preferuj [tunel](/pl/tunnels/) lub sieć prywatną (jak VPN) zamiast otwierania portu do internetu. +- Jeśli umieszczasz OpenChamber za własnym serwerem HTTPS, zobacz [Reverse Proxy](/pl/reverse-proxy/). + +## Powiązane + +- [Tunele](/pl/tunnels/) — zalecany sposób na zdalne dotarcie do instancji +- [Reverse Proxy](/pl/reverse-proxy/) — uruchom OpenChamber za własnym serwerem diff --git a/packages/docs/content/docs/pl/skills-catalog.mdx b/packages/docs/content/docs/pl/skills-catalog.mdx new file mode 100644 index 00000000..56b3724f --- /dev/null +++ b/packages/docs/content/docs/pl/skills-catalog.mdx @@ -0,0 +1,27 @@ +--- +title: Katalog skilli +description: Przeglądaj i instaluj gotowe skille. +--- + +# Katalog skilli + +Katalog skilli pozwala instalować skille opublikowane przez innych zamiast pisania własnych. Otwórz go w **Settings → Skills → Catalog**. + +Aby pisać własne skille, zobacz [Skille](/pl/skills/). + +## Zainstaluj skill + +1. Otwórz katalog. +2. Przeglądaj wbudowane źródła — repozytorium skilli Anthropic oraz rejestr społeczności ClawdHub — albo wyszukaj. +3. Wybierz skill i zainstaluj go. +4. Wybierz, gdzie go zainstalować: dla wszystkiego, co robisz, albo tylko dla bieżącego projektu. + +Jeśli skill o tej samej nazwie już istnieje, OpenChamber zapyta, co zrobić — pominąć go, nadpisać albo zdecydować dla każdego skilla osobno. + +## Dodaj własne źródło + +Możesz dodać dowolne repozytorium Git jako źródło, używając jego nazwy `owner/repo` lub pełnego adresu URL Git. Prywatne repozytoria wymagają skonfigurowanego dostępu na Twojej maszynie (klucz SSH lub zapisane poświadczenia); jeśli źródło nie może się uwierzytelnić, katalog to zgłosi, zamiast po cichu zawieść. + +## Powiązane + +- [Skille](/pl/skills/) — twórz zainstalowanymi skillami i nimi zarządzaj diff --git a/packages/docs/content/docs/pl/skills.mdx b/packages/docs/content/docs/pl/skills.mdx new file mode 100644 index 00000000..7ee8b867 --- /dev/null +++ b/packages/docs/content/docs/pl/skills.mdx @@ -0,0 +1,30 @@ +--- +title: Skille +description: Twórz wielokrotnego użytku instrukcje, które agenci wczytują na żądanie. +--- + +# Skille + +Skill to wielokrotnego użytku zestaw instrukcji, który agent może wczytać, gdy jest istotny — na przykład „jak piszemy komunikaty commitów” albo „nasze konwencje API”. Zarządzasz nimi w **Settings → Skills**. + +Aby zainstalować gotowe skille zamiast pisać własne, zobacz [Katalog skilli](/pl/skills-catalog/). + +## Utwórz skill + +1. Otwórz **Settings → Skills**. +2. Utwórz skill i nadaj mu nazwę oraz krótki opis. Na podstawie opisu agent decyduje, kiedy skill ma zastosowanie, więc niech będzie konkretny. +3. Napisz instrukcje. Dodaj pliki pomocnicze, jeśli skill ich potrzebuje. +4. Wybierz, gdzie ma się znajdować: + - **personal** — dostępny w każdym projekcie + - **project** — dostępny tylko w bieżącym projekcie + +## Użyj skilla w czacie + +Wpisz `/` w środku wiadomości, aby otworzyć selektor skilli, a następnie wybierz jeden. Agent wczyta instrukcje tego skilla na potrzeby odpowiedzi. + +`/` na samym początku wiadomości otwiera natomiast [polecenia](/pl/commands-snippets/). + +## Powiązane + +- [Katalog skilli](/pl/skills-catalog/) — zainstaluj skille opublikowane przez innych +- [Polecenia i fragmenty](/pl/commands-snippets/) — inne sposoby na ponowne użycie tekstu w czacie diff --git a/packages/docs/content/docs/pl/troubleshooting/opencode-connection.mdx b/packages/docs/content/docs/pl/troubleshooting/opencode-connection.mdx new file mode 100644 index 00000000..454969c3 --- /dev/null +++ b/packages/docs/content/docs/pl/troubleshooting/opencode-connection.mdx @@ -0,0 +1,34 @@ +--- +title: Połączenie z OpenCode +description: Napraw brak połączenia OpenChamber z serwerem OpenCode. +--- + +# Połączenie z OpenCode + +Jeśli OpenChamber się ładuje, ale nigdy nie przechodzi poza „OpenCode uruchamia się ponownie”, albo czat nie odpowiada, serwer, z którym się komunikuje, jest nieosiągalny. Przejdź przez te kroki. + +## Utknął na „OpenCode uruchamia się ponownie” + +- daj mu chwilę tuż po uruchomieniu — ten stan jest normalny, gdy serwer startuje +- sprawdź, czy serwer żyje, za pomocą `openchamber status` +- zrestartuj go za pomocą `openchamber restart` +- zobacz szczegóły startu za pomocą `openchamber logs` + +## Łączysz się z własnym serwerem + +Jeśli ustawiłeś OpenChamber tak, aby używał istniejącego serwera, sprawdź ponownie konfigurację z [OpenCode Server](/pl/opencode-server/): + +- `OPENCODE_HOST` musi zawierać port, bez ścieżki — na przykład `http://localhost:4096` +- ustaw `OPENCODE_SKIP_START=true`, aby OpenChamber nie uruchamiał też własnego +- jeśli adres jest nieprawidłowy, OpenChamber go ignoruje i uruchamia własny serwer — poszukaj ostrzeżenia `[config]` w logach + +## Nadal nie działa + +- potwierdź, że Node.js jest w wersji `20` lub nowszej +- przeinstaluj najnowsze CLI +- otwórz `http://localhost:3000` bezpośrednio, zanim przetestujesz jakikolwiek tunel lub zdalny link + +## Powiązane + +- [OpenCode Server](/pl/opencode-server/) — jak OpenChamber znajduje serwer i nim zarządza +- [Rozwiązywanie problemów](/pl/troubleshooting/) — inne częste problemy diff --git a/packages/docs/content/docs/pl/troubleshooting/remote-access.mdx b/packages/docs/content/docs/pl/troubleshooting/remote-access.mdx new file mode 100644 index 00000000..726c6e6e --- /dev/null +++ b/packages/docs/content/docs/pl/troubleshooting/remote-access.mdx @@ -0,0 +1,38 @@ +--- +title: Dostęp zdalny +description: Napraw tunele, zdalne instancje i dostęp do OpenChamber z innego urządzenia. +--- + +# Dostęp zdalny + +Gdy nie możesz dotrzeć do OpenChamber z telefonu lub innej maszyny, rozwiązanie zależy od tego, jak się łączysz. + +## Najpierw sprawdź podstawy + +- najpierw otwórz `http://localhost:3000` na tym samym komputerze — jeśli to zawiedzie, to nie jest problem zdalny; zobacz [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/) +- potwierdź, że serwer działa, za pomocą `openchamber status` + +## Link tunelu nie działa + +- uruchom `openchamber tunnel status --all` +- zrestartuj tunel z tej samej instancji i portu +- wygeneruj ponownie link połączenia, jeśli poprzedni był już użyty + +Zobacz [Tunele](/pl/tunnels/), aby poznać pełną konfigurację. + +## Zdalna instancja nie chce się połączyć (komputer) + +Gdy [zdalna instancja](/pl/remote-instances/) się zatnie, OpenChamber wskazuje krok, który zawiódł: + +- **auth** — Twoje hasło SSH lub UI zostało odrzucone; wpisz je ponownie +- **install / start** — OpenChamber nie mógł skonfigurować lub uruchomić serwera na zdalnej maszynie; sprawdź wymagania tej maszyny +- **forwarding** — połączenie działa, ale port do Ciebie nie dociera; spróbuj innego portu lokalnego + +## Za własnym serwerem + +Jeśli umieściłeś OpenChamber za reverse proxy i ładuje się dziwnie lub nie chce się połączyć, zobacz [Reverse Proxy](/pl/reverse-proxy/). + +## Powiązane + +- [Tunele](/pl/tunnels/) · [Zdalne instancje](/pl/remote-instances/) · [Reverse Proxy](/pl/reverse-proxy/) +- [Bezpieczeństwo](/pl/security/) — zabezpiecz UI przed udostępnieniem diff --git a/packages/docs/content/docs/pl/troubleshooting/worktrees-git.mdx b/packages/docs/content/docs/pl/troubleshooting/worktrees-git.mdx new file mode 100644 index 00000000..871a9a13 --- /dev/null +++ b/packages/docs/content/docs/pl/troubleshooting/worktrees-git.mdx @@ -0,0 +1,35 @@ +--- +title: Worktree i Git +description: Napraw częste problemy z worktree i git. +--- + +# Worktree i Git + +Problemy, które pojawiają się przy [sesjach worktree](/pl/worktrees/) i [widoku git](/pl/git/), oraz jak je usunąć. + +## Worktree wymaga uwagi + +OpenChamber oznacza worktree, gdy coś jest nie tak: + +- **folder missing** — folder worktree został usunięty lub przeniesiony poza OpenChamber; usuń sesję i utwórz świeży worktree +- **detached or unborn branch** — worktree nie jest na zwykłej gałęzi; wyewidencjonuj go na jedną z nich +- **merge, rebase, or cherry-pick in progress** — operacja została niedokończona; dokończ ją lub przerwij z poziomu widoku git + +## Nie można utworzyć worktree + +- **branch already exists** — wybierz inną nazwę gałęzi albo użyj opcji istniejącej gałęzi +- **name already in use** — wybierz inną nazwę worktree + +## Generowanie commita lub PR zawodzi + +Generowanie komunikatu commita lub opisu PR działa w Twojej aktywnej sesji, więc potrzebujesz otwartej sesji z wybranym działającym modelem. Otwórz lub wybierz sesję i spróbuj ponownie. + +## Problemy ze ścieżkami SSH lub Windows + +- upewnij się, że klucz SSH używany przez repozytorium to ten ustawiony w Twojej [tożsamości git](/pl/git-identities/) +- na Windows git używa ścieżek w stylu uniksowym (jak `/c/Users/...`) — OpenChamber to obsługuje, ale niestandardowe ścieżki kluczy SSH powinny mieć taką samą postać + +## Powiązane + +- [Sesje worktree](/pl/worktrees/) — jak tworzone i usuwane są worktree +- [Tożsamości Git](/pl/git-identities/) — ustaw właściwy klucz i tożsamość dla każdego repozytorium diff --git a/packages/docs/content/docs/pl/tunnels.mdx b/packages/docs/content/docs/pl/tunnels.mdx index f2b2071f..cb1e22ae 100644 --- a/packages/docs/content/docs/pl/tunnels.mdx +++ b/packages/docs/content/docs/pl/tunnels.mdx @@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000 ## Powiązane +- [Bezpieczeństwo](/pl/security/) — zabezpiecz interfejs przed udostępnieniem +- [PWA i dostęp z telefonu](/pl/mobile/) — korzystaj z OpenChamber z telefonu - [Rozwiązywanie problemów](/pl/troubleshooting/) — jeśli link tunelu nie działa diff --git a/packages/docs/content/docs/pl/updates.mdx b/packages/docs/content/docs/pl/updates.mdx new file mode 100644 index 00000000..1cac1405 --- /dev/null +++ b/packages/docs/content/docs/pl/updates.mdx @@ -0,0 +1,31 @@ +--- +title: Aktualizacje +description: Aktualizuj OpenChamber na komputerze, w wersji webowej i w VS Code. +--- + +# Aktualizacje + +Sposób aktualizacji OpenChamber zależy od tego, jak go zainstalowałeś. W każdym przypadku możesz sprawdzić swoją bieżącą wersję w **Settings → OpenChamber → About**. + +## Aplikacja na komputerze + +Aplikacja na komputerze sprawdza aktualizacje względem wydań na GitHub. Gdy jedna jest dostępna, OpenChamber Cię informuje, pobiera ją, gdy zdecydujesz, i instaluje przy następnym restarcie. Zawsze masz kontrolę — nic nie instaluje się bez Twojej zgody. + +## Wersja webowa / CLI + +Jeśli zainstalowałeś CLI, zaktualizuj je z poziomu **About** za pomocą przycisków sprawdzania i aktualizacji albo z terminala: + +```bash +openchamber update +``` + +OpenChamber wykrywa, jak został zainstalowany (npm, pnpm, yarn lub bun), i uruchamia właściwą aktualizację za Ciebie. + +## Serwer OpenCode + +OpenChamber i OpenCode aktualizują się osobno. Gdy dostępna jest nowa wersja OpenCode, OpenChamber proponuje jej aktualizację i restartuje serwer po jej zakończeniu. Zobacz [OpenCode Server](/pl/opencode-server/), aby dowiedzieć się, jak ten serwer jest zarządzany. + +## Powiązane + +- [Instalacja](/pl/install/) — jak każda aplikacja jest instalowana na początku +- [OpenCode Server](/pl/opencode-server/) — aktualizacja serwera bazowego diff --git a/packages/docs/content/docs/pl/usage.mdx b/packages/docs/content/docs/pl/usage.mdx new file mode 100644 index 00000000..b37fc12b --- /dev/null +++ b/packages/docs/content/docs/pl/usage.mdx @@ -0,0 +1,28 @@ +--- +title: Zużycie i limity +description: Śledź, ile planu dostawcy już wykorzystałeś. +--- + +# Zużycie i limity + +Strona zużycia pokazuje, ile planu każdego dostawcy wykorzystałeś, dzięki czemu widzisz, jak blisko limitu jesteś. Otwórz ją w **Settings → Usage**. + +## Co widzisz + +Dla każdego połączonego dostawcy OpenChamber pokazuje: + +- ile bieżącego okna wykorzystałeś, w postaci paska +- podział według modelu +- wskaźnik tempa, byś mógł ocenić, czy zmierzasz w stronę wyczerpania limitu + +Możesz wybrać, którzy dostawcy się pojawiają, a to samo podsumowanie jest dostępne z rozwijanego menu w nagłówku aplikacji. + +## Obsługiwani dostawcy + +Zużycie działa dla dostawców, którzy publikują limit, w tym Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud i Wafer. + +Dostawca pokazuje zużycie dopiero po zalogowaniu się do niego na stronie [Dostawcy](/pl/providers/). Kilku dostawców wymaga dodatkowego kroku — na przykład Ollama Cloud odczytuje plik sesji skonfigurowany osobno. Jeśli dostawca nie pokazuje danych, zwykle oznacza to brak tego dodatkowego poświadczenia. + +## Powiązane + +- [Dostawcy, modele i agenci](/pl/providers/) — zaloguj się, zanim pojawi się zużycie diff --git a/packages/docs/content/docs/pl/voice.mdx b/packages/docs/content/docs/pl/voice.mdx new file mode 100644 index 00000000..b62e456c --- /dev/null +++ b/packages/docs/content/docs/pl/voice.mdx @@ -0,0 +1,36 @@ +--- +title: Tryb głosowy +description: Mów do OpenChamber i słuchaj odczytywanych odpowiedzi. +--- + +# Tryb głosowy + +Tryb głosowy pozwala dyktować wiadomości i odsłuchiwać odpowiedzi. Włącz go w **Settings → OpenChamber → Voice**. + +## Odczytywanie odpowiedzi na głos (text-to-speech) + +Wybierz, jak odpowiedzi są wymawiane: + +- **browser** — wbudowane głosy Twojej przeglądarki, bez konfiguracji +- **OpenAI** — głosy OpenAI; wklej swój klucz API i wybierz głos +- **OpenAI-compatible** — dowolna usługa mówiąca w formacie OpenAI; wprowadź jej adres URL oraz, jeśli go potrzebuje, klucz API +- **macOS say** — wbudowane polecenie `say`, na Macach, które je mają + +Po włączeniu na wiadomościach pojawia się przycisk odtwarzania, aby je odsłuchać. + +## Dyktowanie wiadomości (speech-to-text) + +Wybierz, jak Twoja mowa jest transkrybowana: + +- **browser** — wbudowane rozpoznawanie Twojej przeglądarki, bez konfiguracji +- **server** — usługa transkrypcji zgodna z OpenAI; wprowadź jej adres URL oraz, w razie potrzeby, klucz API +- **on-device** — model mowy, który działa w Twojej przeglądarce i pobiera się przy pierwszym użyciu + +## Uwaga dla telefonów + +Do odczytywania odpowiedzi na głos na telefonie najbardziej niezawodne są opcje OpenAI lub OpenAI-compatible — przeglądarki mobilne ograniczają wbudowane głosy. + +## Powiązane + +- [Powiadomienia](/pl/notifications/) — zamiast słuchania otrzymuj ping +- [Dostawcy, modele i agenci](/pl/providers/) — gdzie Twój klucz OpenAI może już się znajdować diff --git a/packages/docs/content/docs/pl/worktrees.mdx b/packages/docs/content/docs/pl/worktrees.mdx new file mode 100644 index 00000000..3b3d893b --- /dev/null +++ b/packages/docs/content/docs/pl/worktrees.mdx @@ -0,0 +1,36 @@ +--- +title: Sesje worktree +description: Daj sesji jej własną gałąź i folder, aby praca pozostała odizolowana. +--- + +# Sesje worktree + +Sesja worktree działa we własnej wyewidencjonowanej kopii Twojego repozytorium, na własnej gałęzi (worktree git). Dzięki temu równoległe sesje nie wchodzą sobie w paradę przy plikach — jedna może refaktoryzować, a druga naprawiać błąd, bez przełączania się tam i z powrotem. + +## Utwórz sesję + +1. Otwórz okno nowego worktree z przycisku u góry paska bocznego sesji. +2. Wybierz punkt startowy: + - **new branch** — nazwij gałąź i wybierz, od której gałęzi zacząć + - **existing branch** — wyewidencjonuj gałąź, którą już masz +3. Potwierdź folder worktree (OpenChamber proponuje jeden na podstawie nazwy gałęzi). +4. Utwórz go. + +OpenChamber tworzy gałąź, konfiguruje folder i uruchamia w nim sesję. Możesz też wystartować jedną prosto z [zadania](/pl/notes-todos-plans/) albo z [issue lub PR na GitHub](/pl/github/). + +## Przywróć pracę + +Gdy praca jest gotowa, użyj **Integrate** w widoku Git, aby przenieść commity worktree na inną gałąź (jak `main`). Jeśli zmiana powoduje konflikt, możesz przekazać konflikt agentowi do rozwiązania. + +## Posprzątaj + +Usunięcie lub zarchiwizowanie sesji może usunąć worktree. Sam decydujesz, czy usunąć również gałąź — lokalną, a zdalną, jeśli istnieje. Nic nie jest usuwane bez Twojej zgody. + +## Jeśli coś wygląda nie tak + +Worktree może wymagać uwagi, jeśli jego folder zniknął, jego gałąź jest w stanie odłączonym (detached) albo scalanie lub rebase jest niedokończone. OpenChamber to oznacza, byś mógł to naprawić — zobacz [Worktree i Git](/pl/troubleshooting/worktrees-git/). + +## Powiązane + +- [Multi-run](/pl/multi-run/) — uruchom wiele sesji worktree naraz +- [Przepływy Git i GitHub](/pl/git/) — commituj i integruj z wnętrza OpenChamber diff --git a/packages/docs/content/docs/preview.mdx b/packages/docs/content/docs/preview.mdx new file mode 100644 index 00000000..7b4562c6 --- /dev/null +++ b/packages/docs/content/docs/preview.mdx @@ -0,0 +1,32 @@ +--- +title: Preview & Dev Servers +description: Open a running dev server inside OpenChamber. +--- + +# Preview & Dev Servers + +When you start a dev server, OpenChamber can open it right inside the app instead of a separate browser tab — so you can see your site next to the chat, capture its console, and point at elements to ask about them. + +## Open a preview + +OpenChamber watches terminal output for a local address (the `Local:` line that tools like Vite, Next.js, or Astro print). When it spots one: + +- in the terminal, an **Open preview** button appears +- a [project action](/project-actions/) with auto-open turned on opens it for you +- a local link in a chat message can open it too + +The site loads in the side panel. Only local addresses (on your own machine) can be previewed. + +## Console and inspect + +In the preview panel you can: + +- watch the page's **console** — errors, warnings, and logs, filtered however you like +- turn on **inspect**, click any element, and send a note about it — selector, styles, position, and a screenshot — straight into chat + +This is the fastest way to tell the agent "this button, here" without describing it. + +## Related + +- [Project Actions](/project-actions/) — auto-open a server when you start it +- [Desktop Browser](/desktop-browser/) — the same tools for any page, on desktop diff --git a/packages/docs/content/docs/project-actions.mdx b/packages/docs/content/docs/project-actions.mdx new file mode 100644 index 00000000..da1ab42e --- /dev/null +++ b/packages/docs/content/docs/project-actions.mdx @@ -0,0 +1,28 @@ +--- +title: Project Actions +description: Save commands you run often and launch them in one click. +--- + +# Project Actions + +A project action is a shell command you save once and run with a click — your dev server, a build, a test run. Each project keeps its own list. Set them up at **Settings → Projects → Project Actions**. + +## Add an action + +1. Open **Settings → Projects** and find the **Project Actions** section. +2. Add an action, give it a name, pick an icon, and enter the command to run. +3. Save. + +You can limit an action to certain operating systems if a command only makes sense on one. + +## Run an action + +Actions live in a menu in the app header. Click one and OpenChamber runs it in a terminal in your project folder, switching you to the terminal view so you can watch the output. Stop it from the same menu. + +## Auto-open a dev server + +Turn on **auto-open URL** for an action that starts a server. OpenChamber watches the output for a local address and offers to open it — see [Preview & Dev Servers](/preview/). On desktop you can also route it through an SSH port forward. + +## Related + +- [Preview & Dev Servers](/preview/) — open a running dev server inside OpenChamber diff --git a/packages/docs/content/docs/project-icons.mdx b/packages/docs/content/docs/project-icons.mdx new file mode 100644 index 00000000..f0eb117b --- /dev/null +++ b/packages/docs/content/docs/project-icons.mdx @@ -0,0 +1,20 @@ +--- +title: Project Icons +description: Give each project a recognizable icon. +--- + +# Project Icons + +A project icon makes it easy to tell your projects apart at a glance. OpenChamber tries to find one for you, and you can always set your own. Manage it at **Settings → Projects**. + +## Automatic discovery + +When you add a project, OpenChamber looks for a `favicon` file inside it and uses that as the project's icon. If your repo already ships a favicon, the icon usually just appears — nothing to do. + +## Set your own + +Open **Settings → Projects** and upload an image (PNG, JPEG, or SVG, up to 5 MB). A custom image takes priority over the auto-discovered one. You can also pick a color instead, or remove the image to fall back to discovery. + +## Related + +- [Projects](/projects/) — name, color, and organize your projects diff --git a/packages/docs/content/docs/projects.mdx b/packages/docs/content/docs/projects.mdx new file mode 100644 index 00000000..dc4f5354 --- /dev/null +++ b/packages/docs/content/docs/projects.mdx @@ -0,0 +1,34 @@ +--- +title: Projects +description: Organize your work into projects and switch between them. +--- + +# Projects + +A project is a folder on your computer that OpenChamber keeps track of — usually one codebase. Switching projects switches the folder the agent works in, along with that project's sessions and settings. + +## Add a project + +You can add a project from a few places: + +- the **Add project** entry in the command palette +- the **+** button at the top of the session sidebar +- the folder browser when you pick a directory + +Point it at a folder and OpenChamber remembers it. The name comes from the folder; you can change it later. + +## Switch projects + +Pick a project from the sidebar to make it active. Everything — sessions, git, notes — follows the project you have open. + +## Make a project recognizable + +Open **Settings → Projects** to give a project a custom name, color, or icon. OpenChamber tries to find an icon automatically — see [Project icons](/project-icons/). + +> In VS Code, OpenChamber always uses the folder you have open as the only project, so there's nothing to add or switch. The Projects settings page is hidden there. + +## Related + +- [Project Notes, Todos & Plans](/notes-todos-plans/) — keep working notes per project +- [Project Actions](/project-actions/) — save commands you run often +- [Context](/context/) — see how much of the model's memory a session is using diff --git a/packages/docs/content/docs/providers.mdx b/packages/docs/content/docs/providers.mdx new file mode 100644 index 00000000..3ca47e22 --- /dev/null +++ b/packages/docs/content/docs/providers.mdx @@ -0,0 +1,49 @@ +--- +title: Providers, Models & Agents +description: Connect AI providers, pick models, and set up agents. +--- + +# Providers, Models & Agents + +Before OpenChamber can do anything, it needs at least one AI provider connected. This page covers connecting a provider, choosing a model, and tailoring agents. + +## Connect a provider + +1. Open **Settings → Providers**. +2. Open the **Add provider** menu and pick a provider that isn't connected yet. +3. Sign in one of two ways, depending on the provider: + - **API key** — paste your key and save. + - **Sign-in (device flow)** — OpenChamber shows a link and a short code. Open the link, enter the code, and approve. OpenChamber finishes connecting on its own. + +When a provider shows as connected, its models become available in chat. + +To disconnect, open the provider and choose to remove its sign-in. + +## Pick a model + +You pick the model where you're working: + +- in chat, use the model picker in the message bar to set the provider and model for that session +- per agent, set a default model (below) + +## Set up agents + +An agent is a named setup — a model, a personality, and what it's allowed to do. + +1. Open **Settings → Agents**. +2. Pick an agent, or create a new one. +3. Edit any of: + - **description** — what the agent is for + - **model** — its default model + - **temperature** — how creative its answers are + - **prompt** — standing instructions it always follows + - **tool rules** — which tools it may use + +## Where your sign-ins live + +Provider sign-ins are stored by OpenCode, not OpenChamber, so they're shared with the OpenCode CLI. If you set the same provider in more than one place, the most specific setting wins: a per-project setting overrides your personal one. + +## Related + +- [MCP Servers](/mcp/) — add extra tools for agents +- [Usage & Quotas](/usage/) — track how much you've used diff --git a/packages/docs/content/docs/pt-br/commands-snippets.mdx b/packages/docs/content/docs/pt-br/commands-snippets.mdx new file mode 100644 index 00000000..59fc681f --- /dev/null +++ b/packages/docs/content/docs/pt-br/commands-snippets.mdx @@ -0,0 +1,39 @@ +--- +title: Comandos e Snippets +description: Crie comandos de barra e trechos de texto reutilizáveis para o chat. +--- + +# Comandos e Snippets + +Comandos e snippets ambos evitam que você redigite a mesma coisa. Comandos são prompts inteiros que você dispara com `/`; snippets são pedaços de texto que você insere em uma mensagem com `#`. + +## Comandos + +Um comando é um prompt salvo que você executa com uma barra, como `/review`. Gerencie-os em **Settings → Commands**. + +1. Abra **Settings → Commands** e crie um comando. +2. Dê a ele um nome, uma descrição e o texto do prompt que ele deve enviar. +3. Opcionalmente, fixe-o em um agente ou modelo específico. +4. Escolha o escopo personal ou project. + +No chat, digite `/` como o **primeiro** caractere da mensagem para abrir os comandos e escolha um. Seu texto pode usar marcadores: + +- `$ARGUMENTS` — o que você digitar depois do comando +- `@filename` — insere o conteúdo de um arquivo +- `` !`command` `` — insere a saída de um comando de shell + +Os comandos integrados `init` e `review` podem ser redefinidos, mas não excluídos. + +## Snippets + +Um snippet é um texto reutilizável que você referencia inline com uma cerquilha, como `#signoff`. Gerencie-os em **Settings → Snippets**. + +1. Abra **Settings → Snippets** e crie um snippet. +2. Dê a ele um nome e o texto que ele representa. Adicione aliases se quiser mais de um gatilho. +3. Escolha o escopo personal ou project. + +No chat, digite `#` e escolha um snippet. O OpenChamber substitui pelo texto completo antes de enviar. + +## Relacionado + +- [Skills](/pt-br/skills/) — carregue conjuntos maiores de instruções sob demanda diff --git a/packages/docs/content/docs/pt-br/context.mdx b/packages/docs/content/docs/pt-br/context.mdx new file mode 100644 index 00000000..948865fd --- /dev/null +++ b/packages/docs/content/docs/pt-br/context.mdx @@ -0,0 +1,38 @@ +--- +title: Contexto +description: Veja quanto da memória do modelo uma sessão está usando. +--- + +# Contexto + +Todo modelo só consegue manter uma certa quantidade de uma conversa de uma vez — o seu contexto. O OpenChamber mostra o quão cheio isso está, para que você saiba quando uma sessão está chegando perto do limite e uma resposta pode começar a descartar detalhes mais antigos. + +## O indicador rápido + +Enquanto você conversa, um pequeno medidor mostra a porcentagem de contexto usada. Ele muda de cor conforme você enche: + +- verde — bastante espaço +- amarelo — ficando cheio (cerca de três quartos) +- vermelho — quase cheio + +Passe o mouse sobre ele (ou toque nele no celular) para ver as contagens exatas de tokens. + +## O painel completo de contexto + +Abra a aba **Context** na barra lateral direita para uma visão mais completa da sessão atual: + +- o modelo em uso e quando a sessão começou +- total de tokens em relação ao limite do modelo +- totais de mensagens e custo +- um detalhamento dos tokens da última resposta +- uma divisão aproximada do que está ocupando o contexto (suas mensagens, as do agente, saída de ferramentas) + +O detalhamento é uma estimativa, não uma contagem exata — use-o para identificar o que está enchendo a janela, não para faturamento. + +## O que fazer quando está cheio + +Comece uma sessão nova para uma nova tarefa em vez de deixar uma sessão crescer para sempre. Um contexto mais curto é mais rápido e mantém o modelo focado. + +## Relacionado + +- [Projetos](/pt-br/projects/) — as sessões são agrupadas por projeto diff --git a/packages/docs/content/docs/pt-br/desktop-browser.mdx b/packages/docs/content/docs/pt-br/desktop-browser.mdx new file mode 100644 index 00000000..2056056d --- /dev/null +++ b/packages/docs/content/docs/pt-br/desktop-browser.mdx @@ -0,0 +1,22 @@ +--- +title: Navegador no Desktop +description: Navegue por qualquer página dentro do app de desktop, com inspeção e captura de console. +--- + +# Navegador no Desktop + +O app de desktop tem um navegador integrado para você abrir qualquer página logo ao lado do seu chat, apontar para elementos para perguntar sobre eles e capturar o console da página. Abra-o pelo botão de globo no cabeçalho do app. + +> O navegador no desktop é um recurso **apenas para desktop**. Na web, o painel de [preview](/pt-br/preview/) oferece as mesmas ferramentas de inspeção e console para o seu servidor de desenvolvimento local. + +## Inspecionar e anotar + +Ative o **inspect** e clique em qualquer elemento da página. O OpenChamber captura uma nota sobre ele — o que é, seus estilos, onde fica e uma captura de tela — e a anexa à sua mensagem no chat. É a forma mais rápida de dizer ao agente "este elemento, bem aqui". + +## Captura de console + +O navegador coleta a saída do console da página — erros, avisos e logs — para que você possa filtrá-la e lê-la sem abrir as ferramentas de desenvolvedor. + +## Relacionado + +- [Preview e Servidores de Desenvolvimento](/pt-br/preview/) — as mesmas ferramentas para o seu servidor de desenvolvimento local diff --git a/packages/docs/content/docs/pt-br/git-identities.mdx b/packages/docs/content/docs/pt-br/git-identities.mdx new file mode 100644 index 00000000..93eee485 --- /dev/null +++ b/packages/docs/content/docs/pt-br/git-identities.mdx @@ -0,0 +1,30 @@ +--- +title: Identidades Git +description: Faça commit com o nome e e-mail certos para cada repositório. +--- + +# Identidades Git + +Uma identidade git é o nome e o e-mail com que seus commits são assinados. Se você trabalha em repositórios pessoais e de trabalho, pode salvar identidades e aplicar a certa por repositório, em vez de depender de uma única configuração global. Gerencie-as em **Settings → Git**. + +## Adicionar uma identidade + +1. Abra **Settings → Git** e escolha **New**. +2. Insira o **nome** e o **e-mail** com que fazer commit. +3. Escolha como ela se autentica com o remoto: + - **SSH** — aponte-a para uma chave SSH + - **token** — use uma credencial salva para um host +4. Opcionalmente, dê a ela uma cor e um ícone para ser fácil de identificar. + +A identidade global do seu sistema também é exibida, somente leitura. + +## Aplicar uma identidade a um repositório + +Aplicar uma identidade a escreve na configuração git **local** daquele repositório — afeta apenas aquele repositório, não a sua configuração global. As identidades SSH também definem o comando SSH para usar sua chave; as identidades de token configuram o armazenamento de credenciais para o host. + +Você pode importar identidades que o OpenChamber descobre nas suas credenciais git existentes e salvá-las como identidades de token. + +## Relacionado + +- [Fluxos de Git e GitHub](/pt-br/git/) — faça commit usando a identidade que você definiu +- [Issues e PRs do GitHub](/pt-br/github/) — conecte uma conta do GitHub para PRs diff --git a/packages/docs/content/docs/pt-br/git.mdx b/packages/docs/content/docs/pt-br/git.mdx new file mode 100644 index 00000000..aa7eee7a --- /dev/null +++ b/packages/docs/content/docs/pt-br/git.mdx @@ -0,0 +1,41 @@ +--- +title: Fluxos de Git e GitHub +description: Faça stage, commit e gerencie branches sem sair do OpenChamber. +--- + +# Fluxos de Git e GitHub + +O OpenChamber tem uma visão de git integrada para você revisar mudanças, fazer commit e gerenciar branches sem mudar para um terminal. Abra-a pela aba **Git** na barra lateral direita. + +## Revisar e fazer commit + +A visão de git divide suas mudanças em **staged** e **unstaged**: + +- clique no **+** de um arquivo para fazer stage dele, ou **−** para remover do stage +- faça stage ou unstage de tudo de um grupo de uma vez +- clique em um arquivo para ver seu diff + +Então escreva uma mensagem de commit e faça o commit. Você pode fazer o OpenChamber **gerar uma mensagem de commit** a partir das suas mudanças em stage — ele usa o modelo da sessão atual, então você precisa de uma sessão aberta. + +## Branches e histórico + +A visão de git também cobre o resto do dia a dia do git: + +- criar, trocar, renomear e excluir branches +- push, pull e fetch +- navegar pelo histórico e diffs por commit +- guardar (stash) e restaurar mudanças + +## Pull requests + +Conecte o GitHub (veja [Issues e PRs do GitHub](/pt-br/github/)) e a aba **PR** permite abrir um pull request, atualizá-lo, marcá-lo como pronto ou fazer merge — e gerar seu título e descrição da mesma forma que as mensagens de commit. + +## Trazendo conflitos + +Se um merge, rebase ou integração encontra um conflito, o OpenChamber mostra o que está travado e permite resolvê-lo — incluindo entregá-lo ao agente. + +## Relacionado + +- [Issues e PRs do GitHub](/pt-br/github/) — conecte o GitHub e comece o trabalho a partir de issues +- [Sessões de Worktree](/pt-br/worktrees/) — isole um branch em sua própria pasta +- [Identidades Git](/pt-br/git-identities/) — faça commit como a pessoa certa por repositório diff --git a/packages/docs/content/docs/pt-br/github.mdx b/packages/docs/content/docs/pt-br/github.mdx new file mode 100644 index 00000000..8379b8f6 --- /dev/null +++ b/packages/docs/content/docs/pt-br/github.mdx @@ -0,0 +1,34 @@ +--- +title: Issues e PRs do GitHub +description: Conecte o GitHub e inicie sessões a partir de issues e pull requests. +--- + +# Issues e PRs do GitHub + +Conecte sua conta do GitHub e o OpenChamber pode trazer issues e pull requests, iniciar uma sessão direto a partir de uma delas e abrir ou atualizar PRs para você. + +## Conectar o GitHub + +1. Abra **Settings → Git**. +2. Em GitHub, escolha **Connect**. O OpenChamber mostra um link e um código curto. +3. Abra o link, insira o código e aprove. + +Quando estiver conectado, sua conta aparece na seção do GitHub. Você pode conectar mais de uma conta e alternar entre elas, ou desconectar a qualquer momento. + +## Começar o trabalho a partir de uma issue ou PR + +Quando você cria uma [sessão de worktree](/pt-br/worktrees/) com o GitHub conectado, pode escolher **Start from GitHub issue/PR**: + +- escolha uma **issue** e o OpenChamber nomeia o branch a partir dela e abre a sessão com a issue e seus comentários como a primeira mensagem +- escolha um **pull request** e ele faz checkout do branch do PR; você pode incluir o diff do PR para que o agente tenha a mudança completa + +Isso o coloca direto em uma sessão com o contexto já carregado. + +## Abrir e gerenciar pull requests + +Pela aba **PR** na [visão de git](/pt-br/git/), você pode criar um pull request, atualizá-lo, marcar um rascunho como pronto ou fazer merge. O OpenChamber pode gerar o título e a descrição do PR a partir das suas mudanças. + +## Relacionado + +- [Fluxos de Git e GitHub](/pt-br/git/) — faça commit e gerencie branches +- [Sessões de Worktree](/pt-br/worktrees/) — onde as sessões de issue e PR começam diff --git a/packages/docs/content/docs/pt-br/index.mdx b/packages/docs/content/docs/pt-br/index.mdx index 20e44d95..6298cc9d 100644 --- a/packages/docs/content/docs/pt-br/index.mdx +++ b/packages/docs/content/docs/pt-br/index.mdx @@ -20,6 +20,13 @@ Use esta documentação para: - [Túneis](/pt-br/tunnels/) - [Solução de problemas](/pt-br/troubleshooting/) +## Explore + +- [Projetos](/pt-br/projects/) e [Sessões de Worktree](/pt-br/worktrees/) — organize e isole seu trabalho +- [Provedores, Modelos e Agentes](/pt-br/providers/) — conecte o OpenCode e escolha um modelo +- [Fluxos de Git e GitHub](/pt-br/git/) — faça commits, revise e abra PRs +- [Segurança](/pt-br/security/) e [Túneis](/pt-br/tunnels/) — proteja sua instância e acesse-a + ## Para que serve o OpenChamber O OpenChamber é voltado para as partes da programação com IA que se beneficiam de um centro de controle: ramificar sessões, revisar diffs, gerenciar terminais, acompanhar o progresso das ferramentas, executar ações de projeto e manter todo o painel à vista enquanto o agente trabalha. diff --git a/packages/docs/content/docs/pt-br/magic-prompts.mdx b/packages/docs/content/docs/pt-br/magic-prompts.mdx new file mode 100644 index 00000000..a4abf88d --- /dev/null +++ b/packages/docs/content/docs/pt-br/magic-prompts.mdx @@ -0,0 +1,26 @@ +--- +title: Magic Prompts +description: Personalize os prompts integrados por trás dos fluxos automatizados do OpenChamber. +--- + +# Magic Prompts + +O OpenChamber usa prompts integrados nos bastidores sempre que faz algo automaticamente — escrever uma mensagem de commit, redigir um PR, revisar uma issue, resolver um conflito, resumir uma sessão. Os Magic Prompts são onde você lê e reescreve esses prompts. Abra-os em **Settings → Magic Prompts**. + +Você não precisa desta página para o uso normal. Recorra a ela quando quiser que um fluxo se comporte de forma diferente — digamos, mensagens de commit em um estilo específico. + +## Editar um prompt + +1. Abra **Settings → Magic Prompts**. +2. Escolha um prompt entre os grupos na barra lateral — Git, GitHub, Planning e Session. +3. Edite o texto e salve. + +Alguns prompts têm uma parte visível (a mensagem que você veria) e uma parte de instruções (orientação oculta para o agente). Os prompts podem incluir `{{placeholders}}` que o OpenChamber preenche, como o diff ou o título da issue — mantenha-os no lugar. + +## Redefinir + +Mudou de ideia? Cada prompt tem **reset to default**, e há um **reset all** se você quiser recomeçar em tudo. + +## Relacionado + +- [Fluxos de Git e GitHub](/pt-br/git/) — muitos desses prompts alimentam os fluxos de git diff --git a/packages/docs/content/docs/pt-br/mcp.mdx b/packages/docs/content/docs/pt-br/mcp.mdx new file mode 100644 index 00000000..b0a95071 --- /dev/null +++ b/packages/docs/content/docs/pt-br/mcp.mdx @@ -0,0 +1,30 @@ +--- +title: Servidores MCP +description: Adicione servidores MCP para dar ferramentas extras aos agentes. +--- + +# Servidores MCP + +Um servidor MCP dá aos seus agentes ferramentas extras — coisas como pesquisar em um banco de dados, chamar uma API ou ler um serviço que você usa. Adicione-os em **Settings → MCP**. + +## Adicionar um servidor + +1. Abra **Settings → MCP**. +2. Adicione um servidor e escolha seu tipo: + - **local** — o OpenChamber executa um comando na sua máquina. Você fornece o comando a ser executado e, se necessário, variáveis de ambiente. + - **remote** — o OpenChamber conecta a uma URL hospedada por outra pessoa. Você fornece a URL e quaisquer cabeçalhos necessários (por exemplo, um token de autenticação). +3. Salve. O servidor fica ativado por padrão; você pode desativá-lo sem excluí-lo. + +## Onde se aplica + +Escolha o escopo ao adicionar um servidor: + +- **personal** — disponível em todos os projetos +- **project** — disponível apenas no projeto atual e salvo junto com as outras configurações do projeto + +Os nomes de servidor usam letras minúsculas, números, hifens e sublinhados. + +## Relacionado + +- [Provedores, Modelos e Agentes](/pt-br/providers/) — conecte um modelo primeiro +- [Skills](/pt-br/skills/) — outra forma de ampliar o que os agentes podem fazer diff --git a/packages/docs/content/docs/pt-br/mobile.mdx b/packages/docs/content/docs/pt-br/mobile.mdx new file mode 100644 index 00000000..a6e67f8d --- /dev/null +++ b/packages/docs/content/docs/pt-br/mobile.mdx @@ -0,0 +1,31 @@ +--- +title: PWA e Acesso Móvel +description: Instale o OpenChamber como um app e use-o pelo seu celular. +--- + +# PWA e Acesso Móvel + +O app web do OpenChamber instala como um app de celular (um PWA), então você pode mantê-lo na tela inicial e usá-lo em tela cheia. Combine-o com um [túnel](/pt-br/tunnels/) e você poderá acompanhar uma sessão de qualquer lugar. + +## Instalar + +O OpenChamber usa a instalação integrada do seu navegador, então não há download separado: + +- **navegador no desktop** — use a opção **Install** na barra de endereço +- **iPhone/iPad (Safari)** — Compartilhar → **Adicionar à Tela de Início** +- **Android (Chrome)** — menu → **Instalar app** / **Adicionar à tela inicial** + +Uma vez instalado, ele abre em sua própria janela sem os controles do navegador. + +## Acessar pelo seu celular + +Para abrir o OpenChamber no seu celular quando o servidor roda no seu computador, inicie um [túnel](/pt-br/tunnels/) e abra o link (ou escaneie o QR code) no celular. Use uma [senha de UI](/pt-br/security/) forte sempre que fizer isso. + +## Configurações de celular + +Em **Settings → OpenChamber**, algumas opções ajustam a experiência móvel e instalada — o nome instalado do app, a orientação da tela e como o teclado na tela se comporta. + +## Relacionado + +- [Túneis](/pt-br/tunnels/) — acesse sua instância de outra rede +- [Segurança](/pt-br/security/) — proteja a UI antes de expô-la diff --git a/packages/docs/content/docs/pt-br/multi-run.mdx b/packages/docs/content/docs/pt-br/multi-run.mdx new file mode 100644 index 00000000..ff322433 --- /dev/null +++ b/packages/docs/content/docs/pt-br/multi-run.mdx @@ -0,0 +1,34 @@ +--- +title: Multi-run +description: Execute o mesmo prompt em vários modelos ou sessões de uma vez. +--- + +# Multi-run + +O Multi-run lança várias sessões a partir de um único formulário — útil para tentar a mesma tarefa com modelos diferentes e comparar os resultados. Abra-o pelo botão no topo da barra lateral de sessões. + +## Iniciar um multi-run + +1. Abra o lançador de multi-run. +2. Escolha o projeto e nomeie o grupo de execução. +3. Escreva o prompt e escolha os modelos para executá-lo (até cinco por grupo). +4. Escolha se quer **isolate runs**. +5. Lance. + +Cada modelo recebe sua própria sessão, e todas começam com o seu prompt. + +## Execuções isoladas + +Ative **isolate runs** para dar a cada execução seu próprio [worktree](/pt-br/worktrees/) e branch, para que nunca toquem nos mesmos arquivos. Isso requer um repositório git — fica desativado automaticamente para pastas que não são um. Escolha o branch de onde as execuções partem. + +Com o isolamento desativado, cada execução é uma sessão comum na pasta do projeto. + +## Comparando resultados + +Cada execução é uma sessão normal que você pode abrir, ler e manter ou descartar. Se você iniciou execuções para comparar abordagens, revise-as lado a lado e leve a melhor adiante. + +Se uma única execução falha ao iniciar, as outras ainda são lançadas — você só verá menos sessões do que pediu. + +## Relacionado + +- [Sessões de Worktree](/pt-br/worktrees/) — como o isolamento funciona por baixo dos panos diff --git a/packages/docs/content/docs/pt-br/notes-todos-plans.mdx b/packages/docs/content/docs/pt-br/notes-todos-plans.mdx new file mode 100644 index 00000000..8013eb44 --- /dev/null +++ b/packages/docs/content/docs/pt-br/notes-todos-plans.mdx @@ -0,0 +1,37 @@ +--- +title: Notas, Tarefas e Planos do Projeto +description: Mantenha notas, uma lista de tarefas e planos salvos para cada projeto. +--- + +# Notas, Tarefas e Planos do Projeto + +Cada projeto tem seu próprio espaço de rascunho para notas, uma lista de tarefas e planos salvos. Eles pertencem ao projeto, não a uma única sessão, então permanecem conforme você se move entre sessões. Encontre-os na aba **Context** da barra lateral direita (uma aba dedicada no celular). + +## Notas + +Uma caixa de notas em formato livre para qualquer coisa que você queira lembrar sobre o projeto. Ela salva sozinha conforme você digita. + +## Tarefas + +Uma lista de verificação simples. Adicione itens, marque-os como concluídos, reordene-os arrastando e limpe os finalizados. + +Cada tarefa tem um menu **send** para você entregá-la ao agente: + +- envie-a para a sessão atual +- inicie uma nova sessão com ela +- inicie uma nova [sessão de worktree](/pt-br/worktrees/) com ela (apenas quando o projeto é um repositório git) + +## Planos + +Um lugar para manter planos mais longos como arquivos salvos. Você pode: + +- importar um plano de um arquivo Markdown ou de texto +- abrir um plano para lê-lo no painel lateral +- excluir planos que você não precisa mais + +Você deve voltar à aba Context com sua nota salva, sua tarefa marcada ou seu plano listado — é assim que você sabe que deu certo. + +## Relacionado + +- [Sessões de Worktree](/pt-br/worktrees/) — execute uma tarefa em seu próprio branch +- [Projetos](/pt-br/projects/) — estes pertencem ao projeto ativo diff --git a/packages/docs/content/docs/pt-br/notifications.mdx b/packages/docs/content/docs/pt-br/notifications.mdx new file mode 100644 index 00000000..10fae579 --- /dev/null +++ b/packages/docs/content/docs/pt-br/notifications.mdx @@ -0,0 +1,34 @@ +--- +title: Notificações +description: Seja avisado quando uma sessão precisa de você ou termina. +--- + +# Notificações + +As notificações avisam você quando algo precisa da sua atenção, para que você não precise ficar olhando a tela — uma sessão terminou, encontrou um erro, fez uma pergunta ou precisa de permissão para fazer algo. Configure-as em **Settings → OpenChamber → Notifications**. + +## Ativar + +1. Abra **Settings → OpenChamber → Notifications**. +2. Permita as notificações quando seu navegador ou sistema solicitar. +3. Escolha sobre o que você quer ser avisado: + - uma sessão **termina** + - uma sessão encontra um **erro** + - uma sessão **faz uma pergunta** + - uma sessão precisa de **permissão** + - **subtarefas** são concluídas + +## Como elas chegam até você + +- no **desktop**, você recebe notificações nativas do sistema +- em um **navegador ou app instalado**, você recebe notificações web push, então elas chegam mesmo quando a aba está em segundo plano + +Sessões configuradas para auto-aceitar não vão incomodá-lo com notificações de permissão. + +## Personalizar o texto + +Cada tipo de notificação tem um modelo de título e mensagem que você pode editar, usando campos como o nome do agente e o modelo. Há também um limite de quanto da última mensagem é incluído, para que as notificações fiquem curtas. + +## Relacionado + +- [Modo de Voz](/pt-br/voice/) — ouça as respostas lidas em voz alta em vez disso diff --git a/packages/docs/content/docs/pt-br/opencode-server.mdx b/packages/docs/content/docs/pt-br/opencode-server.mdx new file mode 100644 index 00000000..d4beda75 --- /dev/null +++ b/packages/docs/content/docs/pt-br/opencode-server.mdx @@ -0,0 +1,54 @@ +--- +title: OpenCode Server +description: Conecte o OpenChamber a um servidor OpenCode local ou remoto. +--- + +# OpenCode Server + +O OpenChamber roda sobre um servidor OpenCode. Por padrão, ele inicia um para você, então não precisa fazer nada. Você só precisa desta página se quiser apontar o OpenChamber para um servidor que já executa, ou gerenciar o que ele inicia. + +## Como o OpenChamber encontra um servidor + +Quando o OpenChamber inicia, ele procura por um servidor nesta ordem: + +1. reutilizar um servidor que ele já iniciou +2. conectar a um servidor externo, se você indicou (veja abaixo) +3. detectar automaticamente um servidor na porta padrão (`4096`) +4. caso contrário, iniciar e gerenciar o seu próprio + +Se nada estiver configurado, o passo 4 acontece automaticamente e você já está pronto para usar. + +## Conectar a um servidor que você já executa + +Defina estas variáveis antes de iniciar o OpenChamber: + +```bash +OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber +``` + +- `OPENCODE_HOST` — o endereço completo do seu servidor OpenCode, incluindo a porta (um valor como `http://localhost:4096`). Ele não deve ter um caminho no final. +- `OPENCODE_SKIP_START=true` — diz ao OpenChamber para não iniciar o próprio servidor. + +Se você só precisa mudar a porta, defina `OPENCODE_PORT` em vez de `OPENCODE_HOST`. + +Se faltar a porta em `OPENCODE_HOST` ou se ele tiver um caminho, o OpenChamber o ignora e volta a iniciar o próprio servidor. Fique de olho nos logs de inicialização para um aviso `[config]` caso uma conexão esperada não aconteça. + +## Gerenciar o servidor pela CLI + +```bash +openchamber status +openchamber logs +openchamber restart +openchamber stop +``` + +`openchamber` sozinho inicia o servidor em segundo plano. Adicione `--foreground` para mantê-lo anexado ao seu terminal. + +## "OpenCode is restarting" + +Enquanto o servidor está iniciando ou reiniciando, o OpenChamber mostra um estado "OpenCode is restarting" e pausa as requisições até ele estar pronto. Isso é normal logo após a inicialização ou um reinício. Se nunca sair desse estado, veja [Conexão com o OpenCode](/pt-br/troubleshooting/opencode-connection/). + +## Relacionado + +- [Provedores, Modelos e Agentes](/pt-br/providers/) — configure com o que o servidor conversa +- [Conexão com o OpenCode](/pt-br/troubleshooting/opencode-connection/) — se ele não conectar diff --git a/packages/docs/content/docs/pt-br/preview.mdx b/packages/docs/content/docs/pt-br/preview.mdx new file mode 100644 index 00000000..4b7de8e7 --- /dev/null +++ b/packages/docs/content/docs/pt-br/preview.mdx @@ -0,0 +1,32 @@ +--- +title: Preview e Servidores de Desenvolvimento +description: Abra um servidor de desenvolvimento em execução dentro do OpenChamber. +--- + +# Preview e Servidores de Desenvolvimento + +Quando você inicia um servidor de desenvolvimento, o OpenChamber pode abri-lo logo dentro do app em vez de uma aba separada do navegador — para que você veja seu site ao lado do chat, capture seu console e aponte para elementos para perguntar sobre eles. + +## Abrir um preview + +O OpenChamber observa a saída do terminal em busca de um endereço local (a linha `Local:` que ferramentas como Vite, Next.js ou Astro imprimem). Quando ele detecta um: + +- no terminal, aparece um botão **Open preview** +- uma [ação de projeto](/pt-br/project-actions/) com auto-open ativado o abre para você +- um link local em uma mensagem do chat também pode abri-lo + +O site carrega no painel lateral. Apenas endereços locais (na sua própria máquina) podem ter preview. + +## Console e inspeção + +No painel de preview você pode: + +- acompanhar o **console** da página — erros, avisos e logs, filtrados como você quiser +- ativar o **inspect**, clicar em qualquer elemento e enviar uma nota sobre ele — seletor, estilos, posição e uma captura de tela — direto no chat + +Esta é a forma mais rápida de dizer ao agente "este botão, aqui" sem descrevê-lo. + +## Relacionado + +- [Ações de Projeto](/pt-br/project-actions/) — abra um servidor automaticamente ao iniciá-lo +- [Navegador no Desktop](/pt-br/desktop-browser/) — as mesmas ferramentas para qualquer página, no desktop diff --git a/packages/docs/content/docs/pt-br/project-actions.mdx b/packages/docs/content/docs/pt-br/project-actions.mdx new file mode 100644 index 00000000..ad7bebbe --- /dev/null +++ b/packages/docs/content/docs/pt-br/project-actions.mdx @@ -0,0 +1,28 @@ +--- +title: Ações de Projeto +description: Salve comandos que você executa com frequência e dispare-os com um clique. +--- + +# Ações de Projeto + +Uma ação de projeto é um comando de shell que você salva uma vez e executa com um clique — seu servidor de desenvolvimento, um build, uma rodada de testes. Cada projeto mantém sua própria lista. Configure-as em **Settings → Projects → Project Actions**. + +## Adicionar uma ação + +1. Abra **Settings → Projects** e encontre a seção **Project Actions**. +2. Adicione uma ação, dê a ela um nome, escolha um ícone e insira o comando a ser executado. +3. Salve. + +Você pode limitar uma ação a determinados sistemas operacionais se um comando só faz sentido em um deles. + +## Executar uma ação + +As ações ficam em um menu no cabeçalho do app. Clique em uma e o OpenChamber a executa em um terminal na pasta do seu projeto, alternando você para a visão de terminal para que possa acompanhar a saída. Pare-a pelo mesmo menu. + +## Abrir um servidor de desenvolvimento automaticamente + +Ative **auto-open URL** para uma ação que inicia um servidor. O OpenChamber observa a saída em busca de um endereço local e oferece abri-lo — veja [Preview e Servidores de Desenvolvimento](/pt-br/preview/). No desktop, você também pode roteá-lo por um encaminhamento de porta SSH. + +## Relacionado + +- [Preview e Servidores de Desenvolvimento](/pt-br/preview/) — abra um servidor de desenvolvimento em execução dentro do OpenChamber diff --git a/packages/docs/content/docs/pt-br/project-icons.mdx b/packages/docs/content/docs/pt-br/project-icons.mdx new file mode 100644 index 00000000..08bc9a46 --- /dev/null +++ b/packages/docs/content/docs/pt-br/project-icons.mdx @@ -0,0 +1,20 @@ +--- +title: Ícones de Projeto +description: Dê a cada projeto um ícone reconhecível. +--- + +# Ícones de Projeto + +Um ícone de projeto facilita distinguir seus projetos num relance. O OpenChamber tenta encontrar um para você, e você sempre pode definir o seu. Gerencie-o em **Settings → Projects**. + +## Descoberta automática + +Quando você adiciona um projeto, o OpenChamber procura por um arquivo `favicon` dentro dele e o usa como ícone do projeto. Se o seu repositório já traz um favicon, o ícone geralmente simplesmente aparece — nada a fazer. + +## Definir o seu + +Abra **Settings → Projects** e faça upload de uma imagem (PNG, JPEG ou SVG, até 5 MB). Uma imagem personalizada tem prioridade sobre a descoberta automática. Você também pode escolher uma cor em vez disso, ou remover a imagem para voltar à descoberta. + +## Relacionado + +- [Projetos](/pt-br/projects/) — nomeie, dê cor e organize seus projetos diff --git a/packages/docs/content/docs/pt-br/projects.mdx b/packages/docs/content/docs/pt-br/projects.mdx new file mode 100644 index 00000000..94a2c131 --- /dev/null +++ b/packages/docs/content/docs/pt-br/projects.mdx @@ -0,0 +1,34 @@ +--- +title: Projetos +description: Organize seu trabalho em projetos e alterne entre eles. +--- + +# Projetos + +Um projeto é uma pasta no seu computador que o OpenChamber acompanha — geralmente uma base de código. Trocar de projeto troca a pasta em que o agente trabalha, junto com as sessões e configurações daquele projeto. + +## Adicionar um projeto + +Você pode adicionar um projeto a partir de alguns lugares: + +- a entrada **Add project** na paleta de comandos +- o botão **+** no topo da barra lateral de sessões +- o navegador de pastas quando você escolhe um diretório + +Aponte-o para uma pasta e o OpenChamber a memoriza. O nome vem da pasta; você pode mudá-lo depois. + +## Trocar de projeto + +Escolha um projeto na barra lateral para torná-lo ativo. Tudo — sessões, git, notas — segue o projeto que você tem aberto. + +## Tornar um projeto reconhecível + +Abra **Settings → Projects** para dar a um projeto um nome, cor ou ícone personalizado. O OpenChamber tenta encontrar um ícone automaticamente — veja [Ícones de projeto](/pt-br/project-icons/). + +> No VS Code, o OpenChamber sempre usa a pasta que você tem aberta como o único projeto, então não há nada para adicionar ou trocar. A página de configurações de Projects fica oculta lá. + +## Relacionado + +- [Notas, Tarefas e Planos do Projeto](/pt-br/notes-todos-plans/) — mantenha notas de trabalho por projeto +- [Ações de Projeto](/pt-br/project-actions/) — salve comandos que você executa com frequência +- [Contexto](/pt-br/context/) — veja quanto da memória do modelo uma sessão está usando diff --git a/packages/docs/content/docs/pt-br/providers.mdx b/packages/docs/content/docs/pt-br/providers.mdx new file mode 100644 index 00000000..035002bc --- /dev/null +++ b/packages/docs/content/docs/pt-br/providers.mdx @@ -0,0 +1,49 @@ +--- +title: Provedores, Modelos e Agentes +description: Conecte provedores de IA, escolha modelos e configure agentes. +--- + +# Provedores, Modelos e Agentes + +Antes de o OpenChamber poder fazer qualquer coisa, ele precisa de pelo menos um provedor de IA conectado. Esta página cobre conectar um provedor, escolher um modelo e personalizar agentes. + +## Conectar um provedor + +1. Abra **Settings → Providers**. +2. Abra o menu **Add provider** e escolha um provedor que ainda não esteja conectado. +3. Faça login de uma de duas maneiras, dependendo do provedor: + - **Chave de API** — cole sua chave e salve. + - **Login (device flow)** — o OpenChamber mostra um link e um código curto. Abra o link, insira o código e aprove. O OpenChamber conclui a conexão sozinho. + +Quando um provedor aparece como conectado, seus modelos ficam disponíveis no chat. + +Para desconectar, abra o provedor e escolha remover o login dele. + +## Escolher um modelo + +Você escolhe o modelo onde está trabalhando: + +- no chat, use o seletor de modelo na barra de mensagens para definir o provedor e o modelo daquela sessão +- por agente, defina um modelo padrão (abaixo) + +## Configurar agentes + +Um agente é uma configuração nomeada — um modelo, uma personalidade e o que ele tem permissão de fazer. + +1. Abra **Settings → Agents**. +2. Escolha um agente ou crie um novo. +3. Edite qualquer um destes: + - **description** — para que serve o agente + - **model** — seu modelo padrão + - **temperature** — quão criativas são suas respostas + - **prompt** — instruções permanentes que ele sempre segue + - **tool rules** — quais ferramentas ele pode usar + +## Onde ficam seus logins + +Os logins de provedores são armazenados pelo OpenCode, não pelo OpenChamber, então são compartilhados com a CLI do OpenCode. Se você definir o mesmo provedor em mais de um lugar, a configuração mais específica vence: uma configuração por projeto sobrescreve a sua pessoal. + +## Relacionado + +- [Servidores MCP](/pt-br/mcp/) — adicione ferramentas extras para os agentes +- [Uso e Cotas](/pt-br/usage/) — acompanhe quanto você já usou diff --git a/packages/docs/content/docs/pt-br/remote-instances.mdx b/packages/docs/content/docs/pt-br/remote-instances.mdx new file mode 100644 index 00000000..09e440c2 --- /dev/null +++ b/packages/docs/content/docs/pt-br/remote-instances.mdx @@ -0,0 +1,30 @@ +--- +title: Instâncias Remotas +description: Conecte o app de desktop ao OpenChamber em outra máquina via SSH. +--- + +# Instâncias Remotas + +O app de desktop pode conectar ao OpenChamber rodando em outra máquina via SSH — um servidor de trabalho, uma máquina na nuvem, um homelab — e trazer a UI dela para a sua tela como se fosse local. Configure isso em **Settings → Remote Instances**. + +> As instâncias remotas são um recurso **apenas para desktop**. Na web ou no VS Code, conecte a um servidor remoto com as variáveis de ambiente em [OpenCode Server](/pt-br/opencode-server/) em vez disso. + +## Adicionar uma instância remota + +1. Abra **Settings → Remote Instances** e adicione uma. +2. Forneça o comando SSH que você normalmente usaria para alcançar a máquina, mais um apelido. +3. Escolha como o OpenChamber roda ali: + - **managed** — o OpenChamber se instala e inicia na máquina remota + - **external** — conecte a um que já está em execução +4. Conecte. + +O OpenChamber percorre as etapas — verificando a conexão, configurando o remoto, iniciando o servidor e encaminhando a porta — e mostra em que ponto está em cada estágio. Quando chega a **ready**, a UI remota carrega localmente. + +## Credenciais + +Você decide se quer salvar as senhas SSH e de UI ou inseri-las a cada vez. Se a conexão cair, o OpenChamber informa qual etapa falhou para você corrigi-la — veja [Acesso remoto](/pt-br/troubleshooting/remote-access/). + +## Relacionado + +- [OpenCode Server](/pt-br/opencode-server/) — conecte a um servidor remoto na web ou no VS Code +- [Acesso remoto](/pt-br/troubleshooting/remote-access/) — quando uma conexão não se completa diff --git a/packages/docs/content/docs/pt-br/scheduled-tasks.mdx b/packages/docs/content/docs/pt-br/scheduled-tasks.mdx new file mode 100644 index 00000000..2d50f2f6 --- /dev/null +++ b/packages/docs/content/docs/pt-br/scheduled-tasks.mdx @@ -0,0 +1,33 @@ +--- +title: Tarefas Agendadas +description: Execute um prompt automaticamente em uma agenda. +--- + +# Tarefas Agendadas + +Uma tarefa agendada executa um prompt para você em uma agenda — por exemplo, um "resumir as mudanças de ontem" diário ou uma limpeza semanal. Quando ela é executada, o OpenChamber inicia uma nova sessão e envia o prompt sozinho. Abra o agendador pelo botão no topo da barra lateral de sessões. + +## Criar uma tarefa + +1. Abra a caixa de diálogo de tarefas agendadas pela barra lateral de sessões. +2. Adicione uma tarefa e dê a ela um nome. +3. Escolha quando ela é executada: + - **diária** — em um ou mais horários a cada dia + - **semanal** — em dias da semana e horários escolhidos + - **uma vez** — uma única data e hora +4. Defina o que ela faz: o prompt a enviar, e o provedor, modelo e agente a usar. O prompt pode ser um comando de barra, como `/review`. +5. Salve e certifique-se de que a tarefa está ativada. + +Você pode executar qualquer tarefa imediatamente com **run now** para verificar se ela faz o que você espera. + +## Como é o sucesso + +Após uma execução, a tarefa mostra quando rodou pela última vez, se teve êxito e um link para a sessão que ela criou. Se uma execução falha, o erro também é mostrado ali. + +## Tenha em mente + +As tarefas só disparam enquanto o servidor do OpenChamber estiver em execução. Se você o fechar, as execuções agendadas ficam pausadas até ele voltar a funcionar. + +## Relacionado + +- [Comandos e Snippets](/pt-br/commands-snippets/) — reutilize um comando de barra como o prompt diff --git a/packages/docs/content/docs/pt-br/security.mdx b/packages/docs/content/docs/pt-br/security.mdx new file mode 100644 index 00000000..4c31f655 --- /dev/null +++ b/packages/docs/content/docs/pt-br/security.mdx @@ -0,0 +1,37 @@ +--- +title: Segurança +description: Proteja a UI com uma senha e passkeys antes de expô-la. +--- + +# Segurança + +O OpenChamber dá acesso à sua máquina e ao seu código, então proteja-o antes que qualquer pessoa além de você possa alcançá-lo. Esta página cobre a senha de UI, as passkeys e o que saber antes de expor o OpenChamber a uma rede. + +## Definir uma senha de UI + +Inicie o OpenChamber com uma senha e a UI do navegador a solicita: + +```bash +openchamber --ui-password be-creative-here +``` + +Você também pode defini-la com a variável de ambiente `OPENCHAMBER_UI_PASSWORD` em vez de colocá-la na linha de comando. Após o login, o OpenChamber lembra o dispositivo por um tempo para que você não seja solicitado toda vez. + +Sempre defina uma senha se a instância puder ser alcançada por outra pessoa — especialmente por um [túnel](/pt-br/tunnels/) ou pela internet pública. + +## Passkeys + +Uma vez definida uma senha, você pode adicionar passkeys (Face ID, Touch ID, uma chave de segurança) para um login mais rápido. Adicione-as em **Settings → OpenChamber → Passkeys**. + +As passkeys estão vinculadas à senha atual. Se você alterar ou remover a senha, as passkeys salvas são apagadas e você precisará adicioná-las novamente. + +## Antes de expô-lo + +- Por padrão, o OpenChamber só escuta na sua própria máquina (`127.0.0.1`). É preciso uma mudança deliberada para escutar mais amplamente, e você deve definir uma senha primeiro. +- Prefira um [túnel](/pt-br/tunnels/) ou uma rede privada (como uma VPN) a abrir uma porta para a internet. +- Se você colocar o OpenChamber atrás do seu próprio servidor HTTPS, veja [Reverse Proxy](/pt-br/reverse-proxy/). + +## Relacionado + +- [Túneis](/pt-br/tunnels/) — a forma recomendada de alcançar uma instância remotamente +- [Reverse Proxy](/pt-br/reverse-proxy/) — execute o OpenChamber atrás do seu próprio servidor diff --git a/packages/docs/content/docs/pt-br/skills-catalog.mdx b/packages/docs/content/docs/pt-br/skills-catalog.mdx new file mode 100644 index 00000000..00adaa0f --- /dev/null +++ b/packages/docs/content/docs/pt-br/skills-catalog.mdx @@ -0,0 +1,27 @@ +--- +title: Catálogo de Skills +description: Navegue e instale skills prontas. +--- + +# Catálogo de Skills + +O Catálogo de Skills permite instalar skills que outras pessoas publicaram em vez de escrever as suas. Abra-o em **Settings → Skills → Catalog**. + +Para escrever suas próprias skills, veja [Skills](/pt-br/skills/). + +## Instalar uma skill + +1. Abra o catálogo. +2. Navegue pelas fontes integradas — o repositório de skills da Anthropic e o registro comunitário ClawdHub — ou pesquise. +3. Escolha uma skill e instale-a. +4. Escolha onde instalá-la: para tudo o que você faz, ou apenas no projeto atual. + +Se já existir uma skill com o mesmo nome, o OpenChamber pergunta o que fazer — pular, sobrescrever ou decidir por skill. + +## Adicionar sua própria fonte + +Você pode adicionar qualquer repositório Git como fonte usando seu nome `owner/repo` ou uma URL Git completa. Repositórios privados precisam de acesso configurado na sua máquina (uma chave SSH ou credenciais salvas); se uma fonte não conseguir autenticar, o catálogo avisa em vez de falhar silenciosamente. + +## Relacionado + +- [Skills](/pt-br/skills/) — crie e gerencie skills instaladas diff --git a/packages/docs/content/docs/pt-br/skills.mdx b/packages/docs/content/docs/pt-br/skills.mdx new file mode 100644 index 00000000..553e5ffd --- /dev/null +++ b/packages/docs/content/docs/pt-br/skills.mdx @@ -0,0 +1,30 @@ +--- +title: Skills +description: Crie instruções reutilizáveis que os agentes carregam sob demanda. +--- + +# Skills + +Uma skill é um conjunto reutilizável de instruções que um agente pode incorporar quando for relevante — por exemplo, "como escrevemos mensagens de commit" ou "nossas convenções de API". Você as gerencia em **Settings → Skills**. + +Para instalar skills prontas em vez de escrever as suas, veja o [Catálogo de Skills](/pt-br/skills-catalog/). + +## Criar uma skill + +1. Abra **Settings → Skills**. +2. Crie uma skill e dê a ela um nome e uma descrição curta. A descrição é como o agente decide quando a skill se aplica, então seja específico. +3. Escreva as instruções. Adicione arquivos de apoio se a skill precisar deles. +4. Escolha onde ela fica: + - **personal** — disponível em todos os projetos + - **project** — disponível apenas no projeto atual + +## Usar uma skill no chat + +Digite `/` no meio de uma mensagem para abrir o seletor de skills e escolha uma. O agente carrega as instruções daquela skill para a resposta. + +Um `/` logo no início da mensagem abre os [comandos](/pt-br/commands-snippets/) em vez disso. + +## Relacionado + +- [Catálogo de Skills](/pt-br/skills-catalog/) — instale skills que outros publicaram +- [Comandos e Snippets](/pt-br/commands-snippets/) — outras formas de reutilizar texto no chat diff --git a/packages/docs/content/docs/pt-br/troubleshooting/opencode-connection.mdx b/packages/docs/content/docs/pt-br/troubleshooting/opencode-connection.mdx new file mode 100644 index 00000000..eecb6c8c --- /dev/null +++ b/packages/docs/content/docs/pt-br/troubleshooting/opencode-connection.mdx @@ -0,0 +1,34 @@ +--- +title: Conexão com o OpenCode +description: Resolva quando o OpenChamber não conecta ao seu servidor OpenCode. +--- + +# Conexão com o OpenCode + +Se o OpenChamber carrega mas nunca passa de "OpenCode is restarting", ou o chat não responde, o servidor com que ele conversa não está acessível. Trabalhe por estes passos. + +## Está travado em "OpenCode is restarting" + +- dê um momento logo após a inicialização — esse estado é normal enquanto o servidor inicia +- verifique se o servidor está vivo com `openchamber status` +- reinicie-o com `openchamber restart` +- veja os detalhes de inicialização com `openchamber logs` + +## Você está conectando ao seu próprio servidor + +Se você configurou o OpenChamber para usar um servidor existente, confira novamente a configuração de [OpenCode Server](/pt-br/opencode-server/): + +- `OPENCODE_HOST` deve incluir a porta, sem caminho — por exemplo `http://localhost:4096` +- defina `OPENCODE_SKIP_START=true` para que o OpenChamber não inicie também o seu próprio +- se o endereço for inválido, o OpenChamber o ignora e inicia o seu próprio servidor em vez disso — procure por um aviso `[config]` nos logs + +## Ainda falhando + +- confirme que o Node.js é versão `20` ou mais recente +- reinstale a CLI mais recente +- abra `http://localhost:3000` diretamente antes de testar qualquer túnel ou link remoto + +## Relacionado + +- [OpenCode Server](/pt-br/opencode-server/) — como o OpenChamber encontra e gerencia o servidor +- [Solução de problemas](/pt-br/troubleshooting/) — outros problemas comuns diff --git a/packages/docs/content/docs/pt-br/troubleshooting/remote-access.mdx b/packages/docs/content/docs/pt-br/troubleshooting/remote-access.mdx new file mode 100644 index 00000000..08942830 --- /dev/null +++ b/packages/docs/content/docs/pt-br/troubleshooting/remote-access.mdx @@ -0,0 +1,38 @@ +--- +title: Acesso Remoto +description: Resolva túneis, instâncias remotas e o acesso ao OpenChamber de outro dispositivo. +--- + +# Acesso Remoto + +Quando você não consegue alcançar o OpenChamber pelo seu celular ou outra máquina, a solução depende de como você está conectando. + +## Confira o básico primeiro + +- abra `http://localhost:3000` no mesmo computador primeiro — se isso falhar, não é um problema remoto; veja [Conexão com o OpenCode](/pt-br/troubleshooting/opencode-connection/) +- confirme que o servidor está em execução com `openchamber status` + +## O link do túnel não funciona + +- execute `openchamber tunnel status --all` +- reinicie o túnel a partir da mesma instância e porta +- regere o link de conexão se o anterior já foi usado + +Veja [Túneis](/pt-br/tunnels/) para a configuração completa. + +## A instância remota não conecta (desktop) + +Quando uma [instância remota](/pt-br/remote-instances/) trava, o OpenChamber nomeia a etapa que falhou: + +- **auth** — sua senha SSH ou de UI foi rejeitada; insira-a novamente +- **install / start** — o OpenChamber não conseguiu configurar ou iniciar o servidor na máquina remota; verifique os requisitos daquela máquina +- **forwarding** — a conexão está de pé, mas a porta não está chegando até você; tente uma porta local diferente + +## Atrás do seu próprio servidor + +Se você colocou o OpenChamber atrás de um reverse proxy e ele carrega de forma estranha ou não conecta, veja [Reverse Proxy](/pt-br/reverse-proxy/). + +## Relacionado + +- [Túneis](/pt-br/tunnels/) · [Instâncias Remotas](/pt-br/remote-instances/) · [Reverse Proxy](/pt-br/reverse-proxy/) +- [Segurança](/pt-br/security/) — proteja a UI antes de expô-la diff --git a/packages/docs/content/docs/pt-br/troubleshooting/worktrees-git.mdx b/packages/docs/content/docs/pt-br/troubleshooting/worktrees-git.mdx new file mode 100644 index 00000000..283bb328 --- /dev/null +++ b/packages/docs/content/docs/pt-br/troubleshooting/worktrees-git.mdx @@ -0,0 +1,35 @@ +--- +title: Worktrees e Git +description: Resolva problemas comuns de worktree e git. +--- + +# Worktrees e Git + +Problemas que surgem com [sessões de worktree](/pt-br/worktrees/) e a [visão de git](/pt-br/git/), e como resolvê-los. + +## Um worktree precisa de atenção + +O OpenChamber sinaliza um worktree quando algo está errado: + +- **pasta ausente** — a pasta do worktree foi excluída ou movida fora do OpenChamber; remova a sessão e crie um worktree novo +- **branch detached ou unborn** — o worktree não está em um branch normal; faça checkout dele em um +- **merge, rebase ou cherry-pick em andamento** — uma operação ficou pela metade; conclua-a ou aborte-a pela visão de git + +## Não consigo criar um worktree + +- **branch já existe** — escolha um nome de branch diferente, ou use a opção de branch existente +- **nome já em uso** — escolha um nome de worktree diferente + +## A geração de commit ou PR falha + +Gerar uma mensagem de commit ou descrição de PR roda na sua sessão ativa, então você precisa de uma sessão aberta com um modelo funcional selecionado. Abra ou escolha uma sessão e tente novamente. + +## Problemas de SSH ou de caminho no Windows + +- certifique-se de que a chave SSH que o repositório usa é a definida na sua [identidade git](/pt-br/git-identities/) +- no Windows, o git usa caminhos no estilo Unix (como `/c/Users/...`) — o OpenChamber lida com isso, mas caminhos de chave SSH personalizados devem seguir a mesma forma + +## Relacionado + +- [Sessões de Worktree](/pt-br/worktrees/) — como os worktrees são criados e removidos +- [Identidades Git](/pt-br/git-identities/) — defina a chave e a identidade certas por repositório diff --git a/packages/docs/content/docs/pt-br/tunnels.mdx b/packages/docs/content/docs/pt-br/tunnels.mdx index a2b4b856..75bbeb2c 100644 --- a/packages/docs/content/docs/pt-br/tunnels.mdx +++ b/packages/docs/content/docs/pt-br/tunnels.mdx @@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000 ## Relacionado +- [Segurança](/pt-br/security/) — proteja a interface antes de expô-la +- [PWA e Acesso Móvel](/pt-br/mobile/) — acesse o OpenChamber pelo celular - [Solução de problemas](/pt-br/troubleshooting/) — se o link do túnel não funcionar diff --git a/packages/docs/content/docs/pt-br/updates.mdx b/packages/docs/content/docs/pt-br/updates.mdx new file mode 100644 index 00000000..86a816d7 --- /dev/null +++ b/packages/docs/content/docs/pt-br/updates.mdx @@ -0,0 +1,31 @@ +--- +title: Atualizações +description: Mantenha o OpenChamber atualizado no desktop, na web e no VS Code. +--- + +# Atualizações + +Como você atualiza o OpenChamber depende de como o instalou. Em todos os casos, você pode verificar sua versão atual em **Settings → OpenChamber → About**. + +## App de desktop + +O app de desktop verifica atualizações nas releases do GitHub. Quando há uma disponível, o OpenChamber avisa você, baixa-a quando você escolhe e a instala no próximo reinício. Você está sempre no controle — nada é instalado sem a sua autorização. + +## Web / CLI + +Se você instalou a CLI, atualize-a a partir de **About** com os botões de verificar e atualizar, ou pelo terminal: + +```bash +openchamber update +``` + +O OpenChamber detecta como foi instalado (npm, pnpm, yarn ou bun) e executa a atualização certa para você. + +## O servidor OpenCode + +O OpenChamber e o OpenCode são atualizados separadamente. Quando uma nova versão do OpenCode está disponível, o OpenChamber oferece atualizá-la e reinicia o servidor em seguida. Veja [OpenCode Server](/pt-br/opencode-server/) para como esse servidor é gerenciado. + +## Relacionado + +- [Instalação](/pt-br/install/) — como cada app é instalado em primeiro lugar +- [OpenCode Server](/pt-br/opencode-server/) — atualizando o servidor subjacente diff --git a/packages/docs/content/docs/pt-br/usage.mdx b/packages/docs/content/docs/pt-br/usage.mdx new file mode 100644 index 00000000..5251afad --- /dev/null +++ b/packages/docs/content/docs/pt-br/usage.mdx @@ -0,0 +1,28 @@ +--- +title: Uso e Cotas +description: Acompanhe quanto do plano do seu provedor você já usou. +--- + +# Uso e Cotas + +A página de Uso mostra quanto de cada plano de provedor você já usou, para que você veja o quão perto está de um limite. Abra-a em **Settings → Usage**. + +## O que você vê + +Para cada provedor conectado, o OpenChamber mostra: + +- quanto da janela atual você usou, como uma barra +- um detalhamento por modelo +- um indicador de ritmo, para você saber se está a caminho de esgotar + +Você pode escolher quais provedores aparecem, e o mesmo resumo está disponível em um menu suspenso no cabeçalho do app. + +## Provedores suportados + +O uso funciona para os provedores que publicam uma cota, incluindo Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud e Wafer. + +Um provedor só mostra o uso depois que você fez login nele na página de [Provedores](/pt-br/providers/). Alguns provedores precisam de um passo extra — por exemplo, o Ollama Cloud lê um arquivo de sessão que você configura separadamente. Se um provedor não mostra dados, geralmente significa que essa credencial extra está faltando. + +## Relacionado + +- [Provedores, Modelos e Agentes](/pt-br/providers/) — faça login antes de o uso aparecer diff --git a/packages/docs/content/docs/pt-br/voice.mdx b/packages/docs/content/docs/pt-br/voice.mdx new file mode 100644 index 00000000..be7bd4b8 --- /dev/null +++ b/packages/docs/content/docs/pt-br/voice.mdx @@ -0,0 +1,36 @@ +--- +title: Modo de Voz +description: Fale com o OpenChamber e ouça as respostas lidas em voz alta. +--- + +# Modo de Voz + +O modo de voz permite ditar mensagens e ter as respostas lidas de volta para você. Ative-o em **Settings → OpenChamber → Voice**. + +## Ler respostas em voz alta (text-to-speech) + +Escolha como as respostas são faladas: + +- **browser** — as vozes integradas do seu navegador, sem configuração +- **OpenAI** — as vozes da OpenAI; cole sua chave de API e escolha uma voz +- **OpenAI-compatible** — qualquer serviço que fale no formato da OpenAI; insira sua URL e, se precisar, uma chave de API +- **macOS say** — o comando integrado `say`, em Macs que o têm + +Uma vez ativado, você ganha um botão de play nas mensagens para ouvi-las lidas em voz alta. + +## Ditar mensagens (speech-to-text) + +Escolha como sua fala é transcrita: + +- **browser** — o reconhecimento integrado do seu navegador, sem configuração +- **server** — um serviço de transcrição compatível com OpenAI; insira sua URL e, se necessário, uma chave de API +- **on-device** — um modelo de fala que roda no seu navegador e é baixado na primeira vez que você o usa + +## Uma nota para celulares + +Para ler respostas em voz alta em um celular, as opções OpenAI ou OpenAI-compatible são as mais confiáveis — os navegadores móveis limitam as vozes integradas. + +## Relacionado + +- [Notificações](/pt-br/notifications/) — seja avisado em vez de ouvir +- [Provedores, Modelos e Agentes](/pt-br/providers/) — onde sua chave da OpenAI talvez já esteja diff --git a/packages/docs/content/docs/pt-br/worktrees.mdx b/packages/docs/content/docs/pt-br/worktrees.mdx new file mode 100644 index 00000000..1a29c31a --- /dev/null +++ b/packages/docs/content/docs/pt-br/worktrees.mdx @@ -0,0 +1,36 @@ +--- +title: Sessões de Worktree +description: Dê a uma sessão seu próprio branch e pasta para manter o trabalho isolado. +--- + +# Sessões de Worktree + +Uma sessão de worktree roda em sua própria cópia do seu repositório, em seu próprio branch (um worktree do git). Isso impede que sessões paralelas atrapalhem os arquivos umas das outras — uma pode refatorar enquanto outra corrige um bug, sem ficar alternando entre elas. + +## Criar uma + +1. Abra a caixa de diálogo de novo worktree pelo botão no topo da barra lateral de sessões. +2. Escolha um ponto de partida: + - **novo branch** — nomeie o branch e escolha de qual branch partir + - **branch existente** — faça checkout de um branch que você já tem +3. Confirme a pasta do worktree (o OpenChamber sugere uma a partir do nome do branch). +4. Crie-a. + +O OpenChamber cria o branch, configura a pasta e inicia uma sessão nela. Você também pode iniciar uma direto de uma [tarefa](/pt-br/notes-todos-plans/) ou de uma [issue ou PR do GitHub](/pt-br/github/). + +## Trazer o trabalho de volta + +Quando o trabalho estiver bom, use **Integrate** na visão de Git para trazer os commits do worktree para outro branch (como `main`). Se uma mudança conflitar, você pode entregar o conflito ao agente para resolver. + +## Limpeza + +Excluir ou arquivar a sessão pode remover o worktree. Você escolhe se também deve excluir o branch — local, e remoto se houver um. Nada é excluído sem você pedir. + +## Se algo parecer errado + +Um worktree pode precisar de atenção se sua pasta sumiu, se seu branch está em estado detached ou se um merge ou rebase ficou pela metade. O OpenChamber sinaliza esses casos para você corrigi-los — veja [Worktrees e Git](/pt-br/troubleshooting/worktrees-git/). + +## Relacionado + +- [Multi-run](/pt-br/multi-run/) — lance muitas sessões de worktree de uma vez +- [Fluxos de Git e GitHub](/pt-br/git/) — faça commit e integre de dentro do OpenChamber diff --git a/packages/docs/content/docs/remote-instances.mdx b/packages/docs/content/docs/remote-instances.mdx new file mode 100644 index 00000000..8edfb832 --- /dev/null +++ b/packages/docs/content/docs/remote-instances.mdx @@ -0,0 +1,30 @@ +--- +title: Remote Instances +description: Connect the desktop app to OpenChamber on another machine over SSH. +--- + +# Remote Instances + +The desktop app can connect to OpenChamber running on another machine over SSH — a work server, a cloud box, a homelab — and bring its UI to your screen as if it were local. Set this up at **Settings → Remote Instances**. + +> Remote instances are a **desktop-only** feature. On the web or in VS Code, connect to a remote server with the environment variables in [OpenCode Server](/opencode-server/) instead. + +## Add a remote instance + +1. Open **Settings → Remote Instances** and add one. +2. Give it the SSH command you'd normally use to reach the machine, plus a nickname. +3. Choose how OpenChamber runs there: + - **managed** — OpenChamber installs and starts itself on the remote machine + - **external** — connect to one that's already running +4. Connect. + +OpenChamber walks through the steps — checking the connection, setting up the remote, starting the server, and forwarding the port — and shows where it is at each stage. When it reaches **ready**, the remote UI loads locally. + +## Credentials + +You decide whether to save the SSH and UI passwords or enter them each time. If the connection drops, OpenChamber reports which step failed so you can fix it — see [Remote access](/troubleshooting/remote-access/). + +## Related + +- [OpenCode Server](/opencode-server/) — connect to a remote server on web or VS Code +- [Remote access](/troubleshooting/remote-access/) — when a connection won't complete diff --git a/packages/docs/content/docs/scheduled-tasks.mdx b/packages/docs/content/docs/scheduled-tasks.mdx new file mode 100644 index 00000000..fe4bb48a --- /dev/null +++ b/packages/docs/content/docs/scheduled-tasks.mdx @@ -0,0 +1,33 @@ +--- +title: Scheduled Tasks +description: Run a prompt automatically on a schedule. +--- + +# Scheduled Tasks + +A scheduled task runs a prompt for you on a schedule — for example, a daily "summarize yesterday's changes" or a weekly cleanup. When it runs, OpenChamber starts a new session and sends the prompt on its own. Open the scheduler from the button at the top of the session sidebar. + +## Create a task + +1. Open the scheduled tasks dialog from the session sidebar. +2. Add a task and give it a name. +3. Choose when it runs: + - **daily** — at one or more times each day + - **weekly** — on chosen weekdays and times + - **once** — a single date and time +4. Set what it does: the prompt to send, and the provider, model, and agent to use. The prompt can be a slash command, like `/review`. +5. Save, and make sure the task is enabled. + +You can run any task immediately with **run now** to check it does what you expect. + +## What success looks like + +After a run, the task shows when it last ran, whether it succeeded, and a link to the session it created. If a run fails, the error is shown there too. + +## Keep in mind + +Tasks only fire while the OpenChamber server is running. If you close it, scheduled runs are paused until it's back up. + +## Related + +- [Commands & Snippets](/commands-snippets/) — reuse a slash command as the prompt diff --git a/packages/docs/content/docs/security.mdx b/packages/docs/content/docs/security.mdx new file mode 100644 index 00000000..a0afd039 --- /dev/null +++ b/packages/docs/content/docs/security.mdx @@ -0,0 +1,37 @@ +--- +title: Security +description: Protect the UI with a password and passkeys before exposing it. +--- + +# Security + +OpenChamber gives access to your machine and your code, so lock it down before anyone but you can reach it. This page covers the UI password, passkeys, and what to know before exposing OpenChamber to a network. + +## Set a UI password + +Start OpenChamber with a password and the browser UI asks for it: + +```bash +openchamber --ui-password be-creative-here +``` + +You can also set it with the `OPENCHAMBER_UI_PASSWORD` environment variable instead of putting it on the command line. After signing in, OpenChamber remembers the device for a while so you're not asked every time. + +Always set a password if the instance is reachable by anyone else — especially over a [tunnel](/tunnels/) or the public internet. + +## Passkeys + +Once a password is set, you can add passkeys (Face ID, Touch ID, a security key) for quicker sign-in. Add them at **Settings → OpenChamber → Passkeys**. + +Passkeys are tied to the current password. If you change or remove the password, saved passkeys are cleared and you'll add them again. + +## Before you expose it + +- By default OpenChamber only listens on your own machine (`127.0.0.1`). It takes a deliberate change to listen more widely, and you should set a password first. +- Prefer a [tunnel](/tunnels/) or a private network (like a VPN) over opening a port to the internet. +- If you put OpenChamber behind your own HTTPS server, see [Reverse Proxy](/reverse-proxy/). + +## Related + +- [Tunnels](/tunnels/) — the recommended way to reach an instance remotely +- [Reverse Proxy](/reverse-proxy/) — run OpenChamber behind your own server diff --git a/packages/docs/content/docs/skills-catalog.mdx b/packages/docs/content/docs/skills-catalog.mdx new file mode 100644 index 00000000..381a878b --- /dev/null +++ b/packages/docs/content/docs/skills-catalog.mdx @@ -0,0 +1,27 @@ +--- +title: Skills Catalog +description: Browse and install ready-made skills. +--- + +# Skills Catalog + +The Skills Catalog lets you install skills other people have published instead of writing your own. Open it at **Settings → Skills → Catalog**. + +For writing your own skills, see [Skills](/skills/). + +## Install a skill + +1. Open the catalog. +2. Browse the built-in sources — the Anthropic skills repo and the ClawdHub community registry — or search. +3. Pick a skill and install it. +4. Choose where to install it: for everything you do, or just the current project. + +If a skill with the same name already exists, OpenChamber asks what to do — skip it, overwrite it, or decide per skill. + +## Add your own source + +You can add any Git repository as a source using its `owner/repo` name or a full Git URL. Private repositories need access set up on your machine (an SSH key or saved credentials); if a source can't authenticate, the catalog says so rather than failing silently. + +## Related + +- [Skills](/skills/) — create and manage installed skills diff --git a/packages/docs/content/docs/skills.mdx b/packages/docs/content/docs/skills.mdx new file mode 100644 index 00000000..25b1d851 --- /dev/null +++ b/packages/docs/content/docs/skills.mdx @@ -0,0 +1,30 @@ +--- +title: Skills +description: Create reusable instructions that agents load on demand. +--- + +# Skills + +A skill is a reusable set of instructions an agent can pull in when it's relevant — for example, "how we write commit messages" or "our API conventions." You manage them at **Settings → Skills**. + +To install ready-made skills instead of writing your own, see [Skills Catalog](/skills-catalog/). + +## Create a skill + +1. Open **Settings → Skills**. +2. Create a skill and give it a name and a short description. The description is how the agent decides when the skill applies, so make it specific. +3. Write the instructions. Add supporting files if the skill needs them. +4. Choose where it lives: + - **personal** — available in every project + - **project** — available only in the current project + +## Use a skill in chat + +Type `/` in the middle of a message to bring up the skill picker, then choose one. The agent loads that skill's instructions for the response. + +A `/` at the very start of the message opens [commands](/commands-snippets/) instead. + +## Related + +- [Skills Catalog](/skills-catalog/) — install skills others have published +- [Commands & Snippets](/commands-snippets/) — other ways to reuse text in chat diff --git a/packages/docs/content/docs/troubleshooting/opencode-connection.mdx b/packages/docs/content/docs/troubleshooting/opencode-connection.mdx new file mode 100644 index 00000000..af93f20e --- /dev/null +++ b/packages/docs/content/docs/troubleshooting/opencode-connection.mdx @@ -0,0 +1,34 @@ +--- +title: OpenCode Connection +description: Fix OpenChamber not connecting to its OpenCode server. +--- + +# OpenCode Connection + +If OpenChamber loads but never gets past "OpenCode is restarting," or chat won't respond, the server it talks to isn't reachable. Work through these. + +## It's stuck on "OpenCode is restarting" + +- give it a moment right after launch — this state is normal while the server starts +- check whether the server is alive with `openchamber status` +- restart it with `openchamber restart` +- view startup details with `openchamber logs` + +## You're connecting to your own server + +If you set OpenChamber to use an existing server, double-check the setup from [OpenCode Server](/opencode-server/): + +- `OPENCODE_HOST` must include the port, with no path — for example `http://localhost:4096` +- set `OPENCODE_SKIP_START=true` so OpenChamber doesn't also start its own +- if the address is invalid, OpenChamber ignores it and starts its own server instead — look for a `[config]` warning in the logs + +## Still failing + +- confirm Node.js is version `20` or newer +- reinstall the latest CLI +- open `http://localhost:3000` directly before testing any tunnel or remote link + +## Related + +- [OpenCode Server](/opencode-server/) — how OpenChamber finds and manages the server +- [Troubleshooting](/troubleshooting/) — other common issues diff --git a/packages/docs/content/docs/troubleshooting/remote-access.mdx b/packages/docs/content/docs/troubleshooting/remote-access.mdx new file mode 100644 index 00000000..9b5835e1 --- /dev/null +++ b/packages/docs/content/docs/troubleshooting/remote-access.mdx @@ -0,0 +1,38 @@ +--- +title: Remote Access +description: Fix tunnels, remote instances, and reaching OpenChamber from another device. +--- + +# Remote Access + +When you can't reach OpenChamber from your phone or another machine, the fix depends on how you're connecting. + +## Check the basics first + +- open `http://localhost:3000` on the same computer first — if that fails, it's not a remote problem; see [OpenCode connection](/troubleshooting/opencode-connection/) +- confirm the server is running with `openchamber status` + +## Tunnel link doesn't work + +- run `openchamber tunnel status --all` +- restart the tunnel from the same instance and port +- regenerate the connect link if the previous one was already used + +See [Tunnels](/tunnels/) for the full setup. + +## Remote instance won't connect (desktop) + +When a [remote instance](/remote-instances/) stalls, OpenChamber names the step that failed: + +- **auth** — your SSH or UI password was rejected; re-enter it +- **install / start** — OpenChamber couldn't set up or start the server on the remote machine; check that machine's requirements +- **forwarding** — the connection is up but the port isn't reaching you; try a different local port + +## Behind your own server + +If you put OpenChamber behind a reverse proxy and it loads oddly or won't connect, see [Reverse Proxy](/reverse-proxy/). + +## Related + +- [Tunnels](/tunnels/) · [Remote Instances](/remote-instances/) · [Reverse Proxy](/reverse-proxy/) +- [Security](/security/) — protect the UI before exposing it diff --git a/packages/docs/content/docs/troubleshooting/worktrees-git.mdx b/packages/docs/content/docs/troubleshooting/worktrees-git.mdx new file mode 100644 index 00000000..de2a144b --- /dev/null +++ b/packages/docs/content/docs/troubleshooting/worktrees-git.mdx @@ -0,0 +1,35 @@ +--- +title: Worktrees & Git +description: Fix common worktree and git problems. +--- + +# Worktrees & Git + +Issues that come up with [worktree sessions](/worktrees/) and the [git view](/git/), and how to clear them. + +## A worktree needs attention + +OpenChamber flags a worktree when something's off: + +- **folder missing** — the worktree's folder was deleted or moved outside OpenChamber; remove the session and create a fresh worktree +- **detached or unborn branch** — the worktree isn't on a normal branch; check it out onto one +- **merge, rebase, or cherry-pick in progress** — an operation was left half-finished; finish or abort it from the git view + +## Can't create a worktree + +- **branch already exists** — pick a different branch name, or use the existing-branch option +- **name already in use** — choose a different worktree name + +## Commit or PR generation fails + +Generating a commit message or PR description runs in your active session, so you need a session open with a working model selected. Open or pick a session and try again. + +## SSH or Windows path issues + +- make sure the SSH key the repo uses is the one set in your [git identity](/git-identities/) +- on Windows, git uses Unix-style paths (like `/c/Users/...`) — OpenChamber handles this, but custom SSH key paths should follow the same form + +## Related + +- [Worktree Sessions](/worktrees/) — how worktrees are created and removed +- [Git Identities](/git-identities/) — set the right key and identity per repo diff --git a/packages/docs/content/docs/tunnels.mdx b/packages/docs/content/docs/tunnels.mdx index cd86a3d8..32fee0c2 100644 --- a/packages/docs/content/docs/tunnels.mdx +++ b/packages/docs/content/docs/tunnels.mdx @@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000 ## Related +- [Security](/security/) — protect the UI before exposing it +- [PWA & Mobile](/mobile/) — reach OpenChamber from your phone - [Troubleshooting](/troubleshooting/) — if the tunnel link doesn't work diff --git a/packages/docs/content/docs/uk/commands-snippets.mdx b/packages/docs/content/docs/uk/commands-snippets.mdx new file mode 100644 index 00000000..8926e1ef --- /dev/null +++ b/packages/docs/content/docs/uk/commands-snippets.mdx @@ -0,0 +1,39 @@ +--- +title: Команди та сніпети +description: Створюйте багаторазові слеш-команди та текстові сніпети для чату. +--- + +# Команди та сніпети + +І команди, і сніпети рятують вас від повторного набирання того самого. Команди — це цілі промпти, які ви запускаєте через `/`; сніпети — це фрагменти тексту, які ви вставляєте в повідомлення через `#`. + +## Команди + +Команда — це збережений промпт, який ви запускаєте слешем, як-от `/review`. Керуйте ними в **Settings → Commands**. + +1. Відкрийте **Settings → Commands** і створіть команду. +2. Дайте їй назву, опис і текст промпту, який вона має надсилати. +3. За бажанням закріпіть її за конкретним агентом чи моделлю. +4. Виберіть персональну область або область проєкту. + +У чаті введіть `/` як **перший** символ повідомлення, щоб викликати команди, потім оберіть одну. Ваш текст може використовувати заповнювачі: + +- `$ARGUMENTS` — те, що ви вводите після команди +- `@filename` — вставляє вміст файлу +- `` !`command` `` — вставляє вивід shell-команди + +Вбудовані команди `init` та `review` можна скинути, але не можна видалити. + +## Сніпети + +Сніпет — це багаторазовий текст, на який ви посилаєтеся вбудовано через хештег, як-от `#signoff`. Керуйте ними в **Settings → Snippets**. + +1. Відкрийте **Settings → Snippets** і створіть сніпет. +2. Дайте йому назву й текст, який він позначає. Додайте псевдоніми, якщо хочете більше одного тригера. +3. Виберіть персональну область або область проєкту. + +У чаті введіть `#` і виберіть сніпет. OpenChamber підставить повний текст перед надсиланням. + +## Пов'язане + +- [Навички](/uk/skills/) — завантажуйте більші набори інструкцій за потреби diff --git a/packages/docs/content/docs/uk/context.mdx b/packages/docs/content/docs/uk/context.mdx new file mode 100644 index 00000000..5dd0581f --- /dev/null +++ b/packages/docs/content/docs/uk/context.mdx @@ -0,0 +1,38 @@ +--- +title: Контекст +description: Дивіться, скільки пам'яті моделі використовує сесія. +--- + +# Контекст + +Кожна модель може утримувати лише певний обсяг розмови водночас — свій контекст. OpenChamber показує, наскільки той заповнений, щоб ви могли зрозуміти, коли сесія наближається до ліміту й відповідь може почати втрачати старіші деталі. + +## Швидкий індикатор + +Поки ви спілкуєтеся, невеликий датчик показує відсоток використаного контексту. Він змінює колір у міру заповнення: + +- зелений — багато місця +- жовтий — заповнюється (близько трьох чвертей) +- червоний — майже повний + +Наведіть на нього (або торкніться на мобільному), щоб побачити точну кількість токенів. + +## Повна панель контексту + +Відкрийте вкладку **Context** у правій бічній панелі для повнішої картини поточної сесії: + +- використовувана модель і коли почалася сесія +- загальна кількість токенів відносно ліміту моделі +- підсумки повідомлень і вартості +- розподіл токенів останньої відповіді +- приблизний розподіл того, що займає контекст (ваші повідомлення, агента, вивід інструментів) + +Розподіл — це оцінка, а не точний підрахунок; використовуйте його, щоб виявити, що заповнює вікно, а не для виставлення рахунків. + +## Що робити, коли він повний + +Починайте свіжу сесію для нового завдання, а не дозволяйте одній сесії розростатися безкінечно. Коротший контекст швидший і тримає модель зосередженою. + +## Пов'язане + +- [Проєкти](/uk/projects/) — сесії згруповані за проєктами diff --git a/packages/docs/content/docs/uk/desktop-browser.mdx b/packages/docs/content/docs/uk/desktop-browser.mdx new file mode 100644 index 00000000..6ec271d2 --- /dev/null +++ b/packages/docs/content/docs/uk/desktop-browser.mdx @@ -0,0 +1,22 @@ +--- +title: Десктопний браузер +description: Переглядайте будь-яку сторінку всередині десктопного застосунку, з інспекцією та перехопленням консолі. +--- + +# Десктопний браузер + +Десктопний застосунок має вбудований браузер, тож ви можете відкрити будь-яку сторінку просто поруч із чатом, вказувати на елементи, щоб запитати про них, і перехоплювати консоль сторінки. Відкрийте його з кнопки глобуса в заголовку застосунку. + +> Десктопний браузер — це функція **лише для десктопа**. У вебі панель [перегляду](/uk/preview/) пропонує ті самі інструменти інспекції та консолі для вашого локального dev-сервера. + +## Інспекція та анотування + +Увімкніть **inspect** і клікніть будь-який елемент на сторінці. OpenChamber перехоплює нотатку про нього — що це, його стилі, де він розташований, і знімок екрана — і прикріплює її до вашого повідомлення в чаті. Це найшвидший спосіб сказати агентові «ось цей елемент, прямо тут». + +## Перехоплення консолі + +Браузер збирає вивід консолі сторінки — помилки, попередження та логи — щоб ви могли фільтрувати й читати його, не відкриваючи інструменти розробника. + +## Пов'язане + +- [Перегляд і dev-сервери](/uk/preview/) — ті самі інструменти для вашого локального dev-сервера diff --git a/packages/docs/content/docs/uk/git-identities.mdx b/packages/docs/content/docs/uk/git-identities.mdx new file mode 100644 index 00000000..c88909b6 --- /dev/null +++ b/packages/docs/content/docs/uk/git-identities.mdx @@ -0,0 +1,30 @@ +--- +title: Git-ідентичності +description: Комітьте від правильного імені та email для кожного репозиторію. +--- + +# Git-ідентичності + +Git-ідентичність — це ім'я та email, якими підписані ваші коміти. Якщо ви працюєте і з особистими, і з робочими репозиторіями, ви можете зберегти ідентичності й застосовувати правильну для кожного репозиторію, замість покладатися на єдине глобальне налаштування. Керуйте ними в **Settings → Git**. + +## Додавання ідентичності + +1. Відкрийте **Settings → Git** і виберіть **New**. +2. Уведіть **name** та **email**, із якими комітити. +3. Виберіть, як вона автентифікується з віддаленим репозиторієм: + - **SSH** — спрямуйте її на SSH-ключ + - **token** — використовуйте збережені облікові дані для хоста +4. За бажанням дайте їй колір та іконку, щоб її було легко впізнати. + +Глобальна ідентичність вашої системи теж показується, лише для читання. + +## Застосування ідентичності до репозиторію + +Застосування ідентичності записує її в **локальний** git-конфіг цього репозиторію — це впливає лише на цей репозиторій, не на ваше глобальне налаштування. SSH-ідентичності також задають SSH-команду для використання вашого ключа; token-ідентичності налаштовують збереження облікових даних для хоста. + +Ви можете імпортувати ідентичності, які OpenChamber виявляє з ваших наявних git-облікових даних, і зберегти їх як token-ідентичності. + +## Пов'язане + +- [Робочі процеси Git і GitHub](/uk/git/) — комітьте з використанням заданої ідентичності +- [GitHub Issues та PR](/uk/github/) — підключіть акаунт GitHub для PR diff --git a/packages/docs/content/docs/uk/git.mdx b/packages/docs/content/docs/uk/git.mdx new file mode 100644 index 00000000..92200bc5 --- /dev/null +++ b/packages/docs/content/docs/uk/git.mdx @@ -0,0 +1,41 @@ +--- +title: Робочі процеси Git і GitHub +description: Додавайте до staging, комітьте та керуйте гілками, не залишаючи OpenChamber. +--- + +# Робочі процеси Git і GitHub + +OpenChamber має вбудований вигляд git, тож ви можете переглядати зміни, комітити та керувати гілками, не перемикаючись на термінал. Відкрийте його на вкладці **Git** у правій бічній панелі. + +## Перегляд і коміт + +Вигляд git розділяє ваші зміни на **staged** та **unstaged**: + +- клікніть **+** біля файлу, щоб додати його до staging, або **−**, щоб прибрати +- додайте до staging або приберіть усе в групі за раз +- клікніть файл, щоб побачити його diff + +Потім напишіть повідомлення коміту й закомітьте. Ви можете доручити OpenChamber **згенерувати повідомлення коміту** з ваших staged-змін — він використовує модель поточної сесії, тож вам потрібна відкрита сесія. + +## Гілки та історія + +Вигляд git також охоплює щоденну рутину git: + +- створення, перемикання, перейменування та видалення гілок +- push, pull і fetch +- перегляд історії та diff для кожного коміту +- stash і відновлення змін + +## Pull request'и + +Підключіть GitHub (див. [GitHub Issues та PR](/uk/github/)), і вкладка **PR** дасть змогу відкрити pull request, оновити його, позначити готовим чи злити — і згенерувати його заголовок та опис так само, як повідомлення комітів. + +## Внесення конфліктів + +Якщо злиття, rebase чи integrate натрапляє на конфлікт, OpenChamber показує, що застрягло, і дає змогу розв'язати його — зокрема передати агентові. + +## Пов'язане + +- [GitHub Issues та PR](/uk/github/) — підключіть GitHub і починайте роботу з issue +- [Сесії worktree](/uk/worktrees/) — ізолюйте гілку у власній теці +- [Git-ідентичності](/uk/git-identities/) — комітьте від правильної особи для кожного репозиторію diff --git a/packages/docs/content/docs/uk/github.mdx b/packages/docs/content/docs/uk/github.mdx new file mode 100644 index 00000000..b18db2b9 --- /dev/null +++ b/packages/docs/content/docs/uk/github.mdx @@ -0,0 +1,34 @@ +--- +title: GitHub Issues та PR +description: Підключіть GitHub і починайте сесії з issue та pull request'ів. +--- + +# GitHub Issues та PR + +Підключіть свій акаунт GitHub, і OpenChamber зможе підтягувати issue та pull request'и, починати сесію прямо з одного з них і відкривати чи оновлювати PR за вас. + +## Підключення GitHub + +1. Відкрийте **Settings → Git**. +2. Під GitHub виберіть **Connect**. OpenChamber покаже посилання й короткий код. +3. Відкрийте посилання, уведіть код і підтвердьте. + +Коли підключення виконано, ваш акаунт показується в розділі GitHub. Ви можете підключити більше одного акаунта й перемикатися між ними або відключитися будь-коли. + +## Початок роботи з issue чи PR + +Коли ви створюєте [сесію worktree](/uk/worktrees/) з підключеним GitHub, ви можете обрати **Start from GitHub issue/PR**: + +- виберіть **issue**, і OpenChamber назве гілку на його честь і відкриє сесію з issue та його коментарями як першим повідомленням +- виберіть **pull request**, і він викачає гілку PR; ви можете включити diff PR, щоб агент мав повну зміну + +Це закидає вас прямо в сесію з уже завантаженим контекстом. + +## Відкриття pull request'ів і керування ними + +З вкладки **PR** у [вигляді git](/uk/git/) ви можете створити pull request, оновити його, позначити чернетку готовою чи злити її. OpenChamber може згенерувати заголовок та опис PR з ваших змін. + +## Пов'язане + +- [Робочі процеси Git і GitHub](/uk/git/) — комітьте та керуйте гілками +- [Сесії worktree](/uk/worktrees/) — де починаються сесії з issue та PR diff --git a/packages/docs/content/docs/uk/index.mdx b/packages/docs/content/docs/uk/index.mdx index 0210cbcd..57995f40 100644 --- a/packages/docs/content/docs/uk/index.mdx +++ b/packages/docs/content/docs/uk/index.mdx @@ -20,6 +20,13 @@ OpenChamber — це візуальний робочий простір навк - [Тунелі](/uk/tunnels/) - [Усунення несправностей](/uk/troubleshooting/) +## Дослідіть + +- [Проєкти](/uk/projects/) та [Сесії worktree](/uk/worktrees/) — організуйте та ізолюйте свою роботу +- [Провайдери, моделі та агенти](/uk/providers/) — підключіть OpenCode та оберіть модель +- [Робочі процеси Git і GitHub](/uk/git/) — комітьте, переглядайте та відкривайте PR +- [Безпека](/uk/security/) та [Тунелі](/uk/tunnels/) — захистіть свій інстанс і отримайте до нього доступ + ## Для чого OpenChamber OpenChamber створений для тих частин AI-кодингу, яким потрібен командний центр: розгалуження сесій, перегляд діфів, керування терміналами, спостереження за прогресом інструментів, запуск дій проєкту та збереження всієї картини перед очима, поки агент працює. diff --git a/packages/docs/content/docs/uk/magic-prompts.mdx b/packages/docs/content/docs/uk/magic-prompts.mdx new file mode 100644 index 00000000..7141a0f1 --- /dev/null +++ b/packages/docs/content/docs/uk/magic-prompts.mdx @@ -0,0 +1,26 @@ +--- +title: Magic Prompts +description: Налаштовуйте вбудовані промпти, що стоять за автоматизованими процесами OpenChamber. +--- + +# Magic Prompts + +OpenChamber використовує вбудовані промпти за лаштунками щоразу, коли робить щось автоматично, — пише повідомлення коміту, складає PR, переглядає issue, розв'язує конфлікт, підсумовує сесію. Magic Prompts — це місце, де ви читаєте й переписуєте ці промпти. Відкрийте їх у **Settings → Magic Prompts**. + +Ця сторінка не потрібна для звичайного користування. Звертайтеся до неї, коли хочете, щоб процес поводився інакше, — скажімо, повідомлення комітів у певному стилі. + +## Редагування промпту + +1. Відкрийте **Settings → Magic Prompts**. +2. Виберіть промпт із груп у бічній панелі — Git, GitHub, Planning та Session. +3. Відредагуйте текст і збережіть. + +Деякі промпти мають видиму частину (повідомлення, яке ви побачите) та частину з інструкціями (приховані вказівки для агента). Промпти можуть містити `{{placeholders}}`, які OpenChamber заповнює, як-от diff чи заголовок issue, — лишайте їх на місці. + +## Скидання + +Передумали? Кожен промпт має **reset to default**, а ще є **reset all**, якщо хочете почати спочатку всюди. + +## Пов'язане + +- [Робочі процеси Git і GitHub](/uk/git/) — багато з цих промптів живлять git-процеси diff --git a/packages/docs/content/docs/uk/mcp.mdx b/packages/docs/content/docs/uk/mcp.mdx new file mode 100644 index 00000000..7397eb4f --- /dev/null +++ b/packages/docs/content/docs/uk/mcp.mdx @@ -0,0 +1,30 @@ +--- +title: MCP-сервери +description: Додавайте MCP-сервери, щоб дати агентам додаткові інструменти. +--- + +# MCP-сервери + +MCP-сервер дає вашим агентам додаткові інструменти — як-от пошук у базі даних, виклик API чи читання сервісу, яким ви користуєтеся. Додавайте їх у **Settings → MCP**. + +## Додавання сервера + +1. Відкрийте **Settings → MCP**. +2. Додайте сервер і виберіть його тип: + - **local** — OpenChamber запускає команду на вашій машині. Ви вказуєте йому команду для запуску і, за потреби, змінні середовища. + - **remote** — OpenChamber підключається до URL, який хостить хтось інший. Ви вказуєте йому URL і будь-які потрібні заголовки (наприклад, токен автентифікації). +3. Збережіть. Сервер увімкнений за замовчуванням; ви можете вимкнути його, не видаляючи. + +## Де він застосовується + +Виберіть область при додаванні сервера: + +- **personal** — доступний у кожному проєкті +- **project** — доступний лише в поточному проєкті й зберігається разом з іншими налаштуваннями проєкту + +Імена серверів використовують малі літери, цифри, дефіси та підкреслення. + +## Пов'язане + +- [Провайдери, моделі та агенти](/uk/providers/) — спершу підключіть модель +- [Навички](/uk/skills/) — ще один спосіб розширити можливості агентів diff --git a/packages/docs/content/docs/uk/mobile.mdx b/packages/docs/content/docs/uk/mobile.mdx new file mode 100644 index 00000000..f4060d89 --- /dev/null +++ b/packages/docs/content/docs/uk/mobile.mdx @@ -0,0 +1,31 @@ +--- +title: PWA та мобільний доступ +description: Установіть OpenChamber як застосунок і користуйтеся ним із телефона. +--- + +# PWA та мобільний доступ + +Вебзастосунок OpenChamber встановлюється як застосунок для телефона (PWA), тож ви можете тримати його на головному екрані й користуватися ним на весь екран. Поєднайте його з [тунелем](/uk/tunnels/), і ви зможете перевіряти сесію звідусіль. + +## Установлення + +OpenChamber використовує вбудоване встановлення вашого браузера, тож окремого завантаження немає: + +- **десктопний браузер** — скористайтеся опцією **Install** в адресному рядку +- **iPhone/iPad (Safari)** — Поділитися → **Додати на початковий екран** +- **Android (Chrome)** — меню → **Встановити застосунок** / **Додати на головний екран** + +Після встановлення він відкривається у власному вікні без елементів браузера. + +## Доступ із телефона + +Щоб відкрити OpenChamber на телефоні, коли сервер працює на вашому комп'ютері, запустіть [тунель](/uk/tunnels/) і відкрийте посилання (або відскануйте QR-код) на телефоні. Використовуйте надійний [пароль UI](/uk/security/) щоразу, коли це робите. + +## Мобільні налаштування + +Під **Settings → OpenChamber** кілька опцій налаштовують мобільний і встановлений досвід — встановлену назву застосунку, орієнтацію екрана та поведінку екранної клавіатури. + +## Пов'язане + +- [Тунелі](/uk/tunnels/) — дістаньтеся до свого інстансу з іншої мережі +- [Безпека](/uk/security/) — захистіть UI перед тим, як відкривати доступ diff --git a/packages/docs/content/docs/uk/multi-run.mdx b/packages/docs/content/docs/uk/multi-run.mdx new file mode 100644 index 00000000..8f1f92f7 --- /dev/null +++ b/packages/docs/content/docs/uk/multi-run.mdx @@ -0,0 +1,32 @@ +--- +title: Multi-run +description: Запускайте той самий промпт у кількох моделях чи сесіях одночасно. +--- + +# Multi-run + +Multi-run запускає кілька сесій з однієї форми — зручно, щоб спробувати те саме завдання з різними моделями й порівняти результати. Відкрийте його з кнопки вгорі бічної панелі сесій. + +## Запуск multi-run + +1. Відкрийте лаунчер multi-run. +2. Виберіть проєкт і назвіть групу запусків. +3. Напишіть промпт і виберіть моделі, із якими його запустити (до п'яти на групу). +4. Виберіть, чи **ізолювати запуски**. +5. Запустіть. + +Кожна модель отримує власну сесію, і всі вони починаються з вашого промпту. + +## Ізольовані запуски + +Увімкніть **isolate runs**, щоб дати кожному запуску власний [worktree](/uk/worktrees/) і гілку, щоб вони ніколи не торкалися тих самих файлів. Для цього потрібен git-репозиторій — для тек, які ним не є, це вимикається автоматично. Виберіть гілку, від якої починаються запуски. + +З вимкненою ізоляцією кожен запуск — це звичайна сесія в теці проєкту. + +## Порівняння результатів + +Кожен запуск — це звичайна сесія, яку ви можете відкрити, прочитати й зберегти чи відкинути. Якщо ви запустили їх, щоб порівняти підходи, переглядайте їх поруч і несіть найкращий далі. + +## Пов'язане + +- [Сесії worktree](/uk/worktrees/) — як ізоляція працює під капотом diff --git a/packages/docs/content/docs/uk/notes-todos-plans.mdx b/packages/docs/content/docs/uk/notes-todos-plans.mdx new file mode 100644 index 00000000..02661dc2 --- /dev/null +++ b/packages/docs/content/docs/uk/notes-todos-plans.mdx @@ -0,0 +1,37 @@ +--- +title: Нотатки, завдання та плани проєкту +description: Зберігайте нотатки, список завдань і збережені плани для кожного проєкту. +--- + +# Нотатки, завдання та плани проєкту + +Кожен проєкт має власний робочий простір для нотаток, списку завдань і збережених планів. Вони належать проєкту, а не якійсь окремій сесії, тож зберігаються, коли ви переходите між сесіями. Знайдіть їх на вкладці **Context** у правій бічній панелі (окрема вкладка на мобільному). + +## Нотатки + +Поле для довільних нотаток про все, що ви хочете запам'ятати про проєкт. Воно зберігається саме в міру набирання. + +## Завдання + +Простий чеклист. Додавайте пункти, відмічайте виконані, переставляйте їх перетягуванням і очищайте завершені. + +Кожне завдання має меню **send**, щоб ви могли передати його агентові: + +- надіслати в поточну сесію +- почати з ним нову сесію +- почати з ним нову [сесію worktree](/uk/worktrees/) (лише коли проєкт є git-репозиторієм) + +## Плани + +Місце, щоб тримати довші плани як збережені файли. Ви можете: + +- імпортувати план із файлу Markdown чи тексту +- відкрити план, щоб прочитати його в бічній панелі +- видаляти плани, які вам більше не потрібні + +Ви маєте повернутися на вкладку Context зі збереженою нотаткою, відміченим завданням або переліченим планом — так ви розумієте, що все спрацювало. + +## Пов'язане + +- [Сесії worktree](/uk/worktrees/) — запускайте завдання у власній гілці +- [Проєкти](/uk/projects/) — це належить активному проєкту diff --git a/packages/docs/content/docs/uk/notifications.mdx b/packages/docs/content/docs/uk/notifications.mdx new file mode 100644 index 00000000..1ae81651 --- /dev/null +++ b/packages/docs/content/docs/uk/notifications.mdx @@ -0,0 +1,34 @@ +--- +title: Сповіщення +description: Дізнавайтеся, коли сесія потребує вас або завершується. +--- + +# Сповіщення + +Сповіщення повідомляють, коли щось потребує вашої уваги, щоб вам не доводилося стежити за екраном, — сесія завершилася, натрапила на помилку, поставила питання чи потребує дозволу щось зробити. Налаштуйте їх у **Settings → OpenChamber → Notifications**. + +## Увімкнення + +1. Відкрийте **Settings → OpenChamber → Notifications**. +2. Дозвольте сповіщення, коли ваш браузер чи система про це запитає. +3. Виберіть, про що ви хочете дізнаватися: + - сесія **завершується** + - сесія натрапляє на **помилку** + - сесія **ставить питання** + - сесія потребує **дозволу** + - **підзавдання** завершуються + +## Як вони до вас доходять + +- на **десктопі** ви отримуєте нативні системні сповіщення +- у **браузері чи встановленому застосунку** ви отримуєте веб-push-сповіщення, тож вони приходять навіть коли вкладка у фоні + +Сесії, налаштовані на автоприйняття, не докучатимуть вам сповіщеннями про дозволи. + +## Налаштування формулювань + +Кожен вид сповіщення має шаблон заголовка й повідомлення, який ви можете редагувати, використовуючи поля на кшталт імені агента та моделі. Також є обмеження на те, скільки з останнього повідомлення включається, щоб сповіщення лишалися короткими. + +## Пов'язане + +- [Голосовий режим](/uk/voice/) — натомість слухайте відповіді, зачитані вголос diff --git a/packages/docs/content/docs/uk/opencode-server.mdx b/packages/docs/content/docs/uk/opencode-server.mdx new file mode 100644 index 00000000..7e234f0e --- /dev/null +++ b/packages/docs/content/docs/uk/opencode-server.mdx @@ -0,0 +1,54 @@ +--- +title: OpenCode Server +description: Підключіть OpenChamber до локального або віддаленого сервера OpenCode. +--- + +# OpenCode Server + +OpenChamber працює поверх сервера OpenCode. За замовчуванням він сам запускає такий сервер, тож вам нічого робити не доводиться. Ця сторінка потрібна лише тоді, коли ви хочете спрямувати OpenChamber на сервер, який ви вже запускаєте, або керувати тим, що він запускає. + +## Як OpenChamber знаходить сервер + +Коли OpenChamber стартує, він шукає сервер у такому порядку: + +1. повторно використовує сервер, який уже запустив +2. підключається до зовнішнього, якщо ви це налаштували (див. нижче) +3. автоматично виявляє сервер на стандартному порту (`4096`) +4. інакше — запускає й керує власним + +Якщо нічого не налаштовано, крок 4 відбувається автоматично, і все працює. + +## Підключення до сервера, який ви вже запускаєте + +Задайте це перед запуском OpenChamber: + +```bash +OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber +``` + +- `OPENCODE_HOST` — повна адреса вашого сервера OpenCode, разом із портом (значення на кшталт `http://localhost:4096`). У кінці не повинно бути шляху. +- `OPENCODE_SKIP_START=true` — каже OpenChamber не запускати власний сервер. + +Якщо вам потрібно лише змінити порт, задайте `OPENCODE_PORT` замість `OPENCODE_HOST`. + +Якщо в `OPENCODE_HOST` бракує порту або є шлях, OpenChamber ігнорує його й повертається до запуску власного сервера. Слідкуйте за журналами запуску на предмет попередження `[config]`, якщо очікуване підключення не відбулося. + +## Керування сервером із CLI + +```bash +openchamber status +openchamber logs +openchamber restart +openchamber stop +``` + +`openchamber` сам по собі запускає сервер у фоні. Додайте `--foreground`, щоб лишити його прив'язаним до вашого терміналу. + +## «OpenCode перезапускається» + +Поки сервер запускається або перезапускається, OpenChamber показує стан «OpenCode перезапускається» і призупиняє запити, доки той не буде готовий. Це нормально одразу після запуску чи перезапуску. Якщо стан так і не зникає, див. [Підключення до OpenCode](/uk/troubleshooting/opencode-connection/). + +## Пов'язане + +- [Провайдери, моделі та агенти](/uk/providers/) — налаштуйте, із чим спілкується сервер +- [Підключення до OpenCode](/uk/troubleshooting/opencode-connection/) — якщо не вдається підключитися diff --git a/packages/docs/content/docs/uk/preview.mdx b/packages/docs/content/docs/uk/preview.mdx new file mode 100644 index 00000000..1d72039f --- /dev/null +++ b/packages/docs/content/docs/uk/preview.mdx @@ -0,0 +1,32 @@ +--- +title: Перегляд і dev-сервери +description: Відкрийте запущений dev-сервер усередині OpenChamber. +--- + +# Перегляд і dev-сервери + +Коли ви запускаєте dev-сервер, OpenChamber може відкрити його просто всередині застосунку замість окремої вкладки браузера — щоб ви могли бачити свій сайт поруч із чатом, перехоплювати його консоль і вказувати на елементи, щоб запитати про них. + +## Відкриття перегляду + +OpenChamber слідкує за виводом терміналу на предмет локальної адреси (рядок `Local:`, який друкують інструменти на кшталт Vite, Next.js чи Astro). Коли він її помічає: + +- у терміналі з'являється кнопка **Open preview** +- [дія проєкту](/uk/project-actions/) з увімкненим автовідкриттям відкриває її за вас +- локальне посилання в повідомленні чату теж може її відкрити + +Сайт завантажується в бічній панелі. Переглянути можна лише локальні адреси (на вашій власній машині). + +## Консоль та інспекція + +У панелі перегляду ви можете: + +- спостерігати за **консоллю** сторінки — помилки, попередження та логи, відфільтровані як вам зручно +- увімкнути **inspect**, клікнути будь-який елемент і надіслати нотатку про нього — селектор, стилі, позицію та знімок екрана — прямо в чат + +Це найшвидший спосіб сказати агентові «ось ця кнопка, тут», не описуючи її. + +## Пов'язане + +- [Дії проєкту](/uk/project-actions/) — автоматично відкривайте сервер при запуску +- [Десктопний браузер](/uk/desktop-browser/) — ті самі інструменти для будь-якої сторінки на десктопі diff --git a/packages/docs/content/docs/uk/project-actions.mdx b/packages/docs/content/docs/uk/project-actions.mdx new file mode 100644 index 00000000..ca5aea38 --- /dev/null +++ b/packages/docs/content/docs/uk/project-actions.mdx @@ -0,0 +1,28 @@ +--- +title: Дії проєкту +description: Зберігайте команди, які часто запускаєте, і запускайте їх одним кліком. +--- + +# Дії проєкту + +Дія проєкту — це shell-команда, яку ви зберігаєте один раз і запускаєте кліком: ваш dev-сервер, збірка, прогін тестів. Кожен проєкт має власний список. Налаштуйте їх у **Settings → Projects → Project Actions**. + +## Додавання дії + +1. Відкрийте **Settings → Projects** і знайдіть розділ **Project Actions**. +2. Додайте дію, дайте їй назву, виберіть іконку й уведіть команду для запуску. +3. Збережіть. + +Ви можете обмежити дію певними операційними системами, якщо команда має сенс лише на одній. + +## Запуск дії + +Дії живуть у меню в заголовку застосунку. Клікніть одну, і OpenChamber запустить її в терміналі у вашій теці проєкту, перемкнувши вас на вигляд терміналу, щоб ви могли спостерігати за виводом. Зупиніть її з того самого меню. + +## Автовідкриття dev-сервера + +Увімкніть **auto-open URL** для дії, що запускає сервер. OpenChamber слідкує за виводом на предмет локальної адреси й пропонує відкрити її — див. [Перегляд і dev-сервери](/uk/preview/). На десктопі ви також можете спрямувати її через SSH-перенаправлення порту. + +## Пов'язане + +- [Перегляд і dev-сервери](/uk/preview/) — відкрийте запущений dev-сервер усередині OpenChamber diff --git a/packages/docs/content/docs/uk/project-icons.mdx b/packages/docs/content/docs/uk/project-icons.mdx new file mode 100644 index 00000000..3f600e0c --- /dev/null +++ b/packages/docs/content/docs/uk/project-icons.mdx @@ -0,0 +1,20 @@ +--- +title: Іконки проєктів +description: Дайте кожному проєкту впізнавану іконку. +--- + +# Іконки проєктів + +Іконка проєкту допомагає легко відрізняти ваші проєкти з першого погляду. OpenChamber намагається знайти її за вас, а ви завжди можете задати власну. Керуйте нею в **Settings → Projects**. + +## Автоматичне виявлення + +Коли ви додаєте проєкт, OpenChamber шукає файл `favicon` усередині нього й використовує його як іконку проєкту. Якщо ваш репозиторій уже постачається з favicon, іконка зазвичай просто з'являється — нічого робити не треба. + +## Задати власну + +Відкрийте **Settings → Projects** і завантажте зображення (PNG, JPEG чи SVG, до 5 МБ). Власне зображення має пріоритет над автоматично виявленим. Ви також можете натомість вибрати колір або прибрати зображення, щоб повернутися до виявлення. + +## Пов'язане + +- [Проєкти](/uk/projects/) — називайте, додавайте кольори та організовуйте свої проєкти diff --git a/packages/docs/content/docs/uk/projects.mdx b/packages/docs/content/docs/uk/projects.mdx new file mode 100644 index 00000000..9caf3f5d --- /dev/null +++ b/packages/docs/content/docs/uk/projects.mdx @@ -0,0 +1,34 @@ +--- +title: Проєкти +description: Організуйте роботу в проєкти та перемикайтеся між ними. +--- + +# Проєкти + +Проєкт — це тека на вашому комп'ютері, яку відстежує OpenChamber, зазвичай одна кодова база. Перемикання проєктів змінює теку, у якій працює агент, разом із сесіями та налаштуваннями цього проєкту. + +## Додавання проєкту + +Додати проєкт можна з кількох місць: + +- пункт **Add project** у палітрі команд +- кнопка **+** угорі бічної панелі сесій +- оглядач тек, коли ви обираєте каталог + +Вкажіть йому теку, і OpenChamber запам'ятає її. Назва походить від теки; ви можете змінити її пізніше. + +## Перемикання проєктів + +Виберіть проєкт на бічній панелі, щоб зробити його активним. Усе — сесії, git, нотатки — слідує за відкритим проєктом. + +## Зробіть проєкт упізнаваним + +Відкрийте **Settings → Projects**, щоб дати проєкту власну назву, колір чи іконку. OpenChamber намагається знайти іконку автоматично — див. [Іконки проєктів](/uk/project-icons/). + +> У VS Code OpenChamber завжди використовує відкриту теку як єдиний проєкт, тож додавати чи перемикати нічого не потрібно. Сторінка налаштувань Projects там прихована. + +## Пов'язане + +- [Нотатки, завдання та плани проєкту](/uk/notes-todos-plans/) — тримайте робочі нотатки для кожного проєкту +- [Дії проєкту](/uk/project-actions/) — зберігайте команди, які часто запускаєте +- [Контекст](/uk/context/) — дивіться, скільки пам'яті моделі використовує сесія diff --git a/packages/docs/content/docs/uk/providers.mdx b/packages/docs/content/docs/uk/providers.mdx new file mode 100644 index 00000000..693e15a7 --- /dev/null +++ b/packages/docs/content/docs/uk/providers.mdx @@ -0,0 +1,49 @@ +--- +title: Провайдери, моделі та агенти +description: Підключайте AI-провайдерів, обирайте моделі та налаштовуйте агентів. +--- + +# Провайдери, моделі та агенти + +Перш ніж OpenChamber зможе щось робити, до нього треба підключити щонайменше одного AI-провайдера. Ця сторінка охоплює підключення провайдера, вибір моделі та налаштування агентів. + +## Підключення провайдера + +1. Відкрийте **Settings → Providers**. +2. Відкрийте меню **Add provider** й оберіть провайдера, який ще не підключений. +3. Увійдіть одним із двох способів, залежно від провайдера: + - **API key** — вставте свій ключ і збережіть. + - **Sign-in (device flow)** — OpenChamber показує посилання й короткий код. Відкрийте посилання, введіть код і підтвердьте. OpenChamber завершить підключення самостійно. + +Коли провайдер показано як підключений, його моделі стають доступними в чаті. + +Щоб відключити, відкрийте провайдера й виберіть видалення його входу. + +## Вибір моделі + +Модель ви обираєте там, де працюєте: + +- у чаті використовуйте перемикач моделей у рядку повідомлення, щоб задати провайдера й модель для цієї сесії +- для кожного агента задайте модель за замовчуванням (нижче) + +## Налаштування агентів + +Агент — це іменоване налаштування: модель, характер та те, що йому дозволено робити. + +1. Відкрийте **Settings → Agents**. +2. Оберіть агента або створіть нового. +3. Відредагуйте будь-що з: + - **description** — для чого призначений агент + - **model** — його модель за замовчуванням + - **temperature** — наскільки креативними є його відповіді + - **prompt** — постійні інструкції, яких він завжди дотримується + - **tool rules** — якими інструментами він може користуватися + +## Де зберігаються ваші входи + +Входи провайдерів зберігає OpenCode, а не OpenChamber, тож вони спільні з CLI OpenCode. Якщо ви задаєте одного провайдера в кількох місцях, перемагає найбільш специфічне налаштування: налаштування для проєкту має пріоритет над вашим персональним. + +## Пов'язане + +- [MCP Servers](/uk/mcp/) — додайте агентам додаткові інструменти +- [Використання та квоти](/uk/usage/) — відстежуйте, скільки ви витратили diff --git a/packages/docs/content/docs/uk/remote-instances.mdx b/packages/docs/content/docs/uk/remote-instances.mdx new file mode 100644 index 00000000..6c9885e6 --- /dev/null +++ b/packages/docs/content/docs/uk/remote-instances.mdx @@ -0,0 +1,30 @@ +--- +title: Віддалені інстанси +description: Підключайте десктопний застосунок до OpenChamber на іншій машині через SSH. +--- + +# Віддалені інстанси + +Десктопний застосунок може підключатися до OpenChamber, запущеного на іншій машині, через SSH — робочий сервер, хмарну машину, домашню лабораторію — і виводити її UI на ваш екран так, ніби він локальний. Налаштуйте це в **Settings → Remote Instances**. + +> Віддалені інстанси — це функція **лише для десктопа**. У вебі чи у VS Code підключайтеся до віддаленого сервера за допомогою змінних середовища з [OpenCode Server](/uk/opencode-server/). + +## Додавання віддаленого інстансу + +1. Відкрийте **Settings → Remote Instances** і додайте один. +2. Задайте йому SSH-команду, яку ви зазвичай використовуєте, щоб дістатися машини, плюс псевдонім. +3. Виберіть, як OpenChamber запускається там: + - **managed** — OpenChamber установлює й запускає себе на віддаленій машині + - **external** — підключитися до того, що вже запущений +4. Підключіться. + +OpenChamber проходить через кроки — перевірку з'єднання, налаштування віддаленої машини, запуск сервера й перенаправлення порту — і показує, на якому етапі він на кожній стадії. Коли він досягає **ready**, віддалений UI завантажується локально. + +## Облікові дані + +Ви вирішуєте, чи зберігати SSH- та UI-паролі, чи вводити їх щоразу. Якщо з'єднання обривається, OpenChamber повідомляє, який крок збоїв, щоб ви могли виправити — див. [Віддалений доступ](/uk/troubleshooting/remote-access/). + +## Пов'язане + +- [OpenCode Server](/uk/opencode-server/) — підключайтеся до віддаленого сервера у вебі чи VS Code +- [Віддалений доступ](/uk/troubleshooting/remote-access/) — коли з'єднання не завершується diff --git a/packages/docs/content/docs/uk/scheduled-tasks.mdx b/packages/docs/content/docs/uk/scheduled-tasks.mdx new file mode 100644 index 00000000..a2e33468 --- /dev/null +++ b/packages/docs/content/docs/uk/scheduled-tasks.mdx @@ -0,0 +1,33 @@ +--- +title: Заплановані завдання +description: Запускайте промпт автоматично за розкладом. +--- + +# Заплановані завдання + +Заплановане завдання запускає промпт за вас за розкладом — наприклад, щоденне «підсумуй вчорашні зміни» чи щотижневе прибирання. Коли воно спрацьовує, OpenChamber починає нову сесію й надсилає промпт самостійно. Відкрийте планувальник із кнопки вгорі бічної панелі сесій. + +## Створення завдання + +1. Відкрийте діалог запланованих завдань із бічної панелі сесій. +2. Додайте завдання й дайте йому назву. +3. Виберіть, коли воно запускається: + - **daily** — в один або кілька моментів щодня + - **weekly** — у вибрані дні тижня та час + - **once** — одна дата й час +4. Задайте, що воно робить: промпт для надсилання, а також провайдера, модель і агента для використання. Промпт може бути слеш-командою, як-от `/review`. +5. Збережіть і переконайтеся, що завдання ввімкнене. + +Ви можете запустити будь-яке завдання негайно через **run now**, щоб перевірити, що воно робить те, що ви очікуєте. + +## Як виглядає успіх + +Після запуску завдання показує, коли воно востаннє виконувалося, чи воно успішне, і посилання на сесію, яку воно створило. Якщо запуск збоїть, помилка теж показується там. + +## Майте на увазі + +Завдання спрацьовують лише поки запущений сервер OpenChamber. Якщо ви його закриєте, заплановані запуски призупиняються, доки він не повернеться. + +## Пов'язане + +- [Команди та сніпети](/uk/commands-snippets/) — повторно використовуйте слеш-команду як промпт diff --git a/packages/docs/content/docs/uk/security.mdx b/packages/docs/content/docs/uk/security.mdx new file mode 100644 index 00000000..62d6c536 --- /dev/null +++ b/packages/docs/content/docs/uk/security.mdx @@ -0,0 +1,37 @@ +--- +title: Безпека +description: Захистіть UI паролем і ключами доступу перед тим, як відкривати його. +--- + +# Безпека + +OpenChamber дає доступ до вашої машини та вашого коду, тож заблокуйте його, перш ніж до нього зможе дістатися хтось, окрім вас. Ця сторінка охоплює пароль UI, ключі доступу (passkeys) і те, що треба знати перед тим, як відкривати OpenChamber у мережі. + +## Установлення пароля UI + +Запустіть OpenChamber із паролем, і браузерний UI запитуватиме його: + +```bash +openchamber --ui-password be-creative-here +``` + +Ви також можете задати його через змінну середовища `OPENCHAMBER_UI_PASSWORD` замість того, щоб писати його в командному рядку. Після входу OpenChamber на деякий час запам'ятовує пристрій, тож вас не питатимуть щоразу. + +Завжди задавайте пароль, якщо інстанс доступний комусь іще — особливо через [тунель](/uk/tunnels/) чи публічний інтернет. + +## Ключі доступу (passkeys) + +Щойно задано пароль, ви можете додати ключі доступу (Face ID, Touch ID, апаратний ключ безпеки) для швидшого входу. Додайте їх у **Settings → OpenChamber → Passkeys**. + +Ключі доступу прив'язані до поточного пароля. Якщо ви зміните чи приберете пароль, збережені ключі доступу очищаються, і вам доведеться додати їх знову. + +## Перш ніж відкривати доступ + +- За замовчуванням OpenChamber слухає лише вашу власну машину (`127.0.0.1`). Щоб слухати ширше, потрібна свідома зміна, і спершу вам слід задати пароль. +- Надавайте перевагу [тунелю](/uk/tunnels/) чи приватній мережі (як-от VPN) перед відкриттям порту в інтернет. +- Якщо ви ставите OpenChamber за власним HTTPS-сервером, див. [Зворотний проксі](/uk/reverse-proxy/). + +## Пов'язане + +- [Тунелі](/uk/tunnels/) — рекомендований спосіб дістатися до інстансу віддалено +- [Зворотний проксі](/uk/reverse-proxy/) — запускайте OpenChamber за власним сервером diff --git a/packages/docs/content/docs/uk/skills-catalog.mdx b/packages/docs/content/docs/uk/skills-catalog.mdx new file mode 100644 index 00000000..732abeb4 --- /dev/null +++ b/packages/docs/content/docs/uk/skills-catalog.mdx @@ -0,0 +1,27 @@ +--- +title: Каталог навичок +description: Переглядайте та встановлюйте готові навички. +--- + +# Каталог навичок + +Каталог навичок дає змогу встановлювати навички, які опублікували інші люди, замість писати власні. Відкрийте його в **Settings → Skills → Catalog**. + +Про написання власних навичок див. [Навички](/uk/skills/). + +## Встановлення навички + +1. Відкрийте каталог. +2. Перегляньте вбудовані джерела — репозиторій навичок Anthropic та спільнотний реєстр ClawdHub — або скористайтеся пошуком. +3. Оберіть навичку й установіть її. +4. Виберіть, куди встановити: для всього, що ви робите, чи лише для поточного проєкту. + +Якщо навичка з такою назвою вже існує, OpenChamber запитає, що робити, — пропустити її, перезаписати чи вирішувати для кожної навички окремо. + +## Додавання власного джерела + +Ви можете додати будь-який Git-репозиторій як джерело, використовуючи його ім'я `owner/repo` або повний Git-URL. Приватним репозиторіям потрібен налаштований доступ на вашій машині (SSH-ключ або збережені облікові дані); якщо джерело не може автентифікуватися, каталог повідомляє про це, а не мовчки збоїть. + +## Пов'язане + +- [Навички](/uk/skills/) — створюйте та керуйте встановленими навичками diff --git a/packages/docs/content/docs/uk/skills.mdx b/packages/docs/content/docs/uk/skills.mdx new file mode 100644 index 00000000..42d336cb --- /dev/null +++ b/packages/docs/content/docs/uk/skills.mdx @@ -0,0 +1,30 @@ +--- +title: Навички +description: Створюйте багаторазові інструкції, які агенти завантажують за потреби. +--- + +# Навички + +Навичка — це багаторазовий набір інструкцій, який агент може підтягнути, коли він доречний, — наприклад, «як ми пишемо повідомлення комітів» або «наші конвенції API». Керуйте ними в **Settings → Skills**. + +Щоб установити готові навички замість писати власні, див. [Каталог навичок](/uk/skills-catalog/). + +## Створення навички + +1. Відкрийте **Settings → Skills**. +2. Створіть навичку й дайте їй назву та короткий опис. За описом агент вирішує, коли навичка застосовна, тож робіть його конкретним. +3. Напишіть інструкції. Додайте допоміжні файли, якщо навичка їх потребує. +4. Виберіть, де вона зберігається: + - **personal** — доступна в кожному проєкті + - **project** — доступна лише в поточному проєкті + +## Використання навички в чаті + +Введіть `/` посередині повідомлення, щоб викликати перемикач навичок, потім оберіть одну. Агент завантажить інструкції цієї навички для відповіді. + +`/` на самому початку повідомлення натомість відкриває [команди](/uk/commands-snippets/). + +## Пов'язане + +- [Каталог навичок](/uk/skills-catalog/) — установлюйте навички, які опублікували інші +- [Команди та сніпети](/uk/commands-snippets/) — інші способи повторно використовувати текст у чаті diff --git a/packages/docs/content/docs/uk/troubleshooting/opencode-connection.mdx b/packages/docs/content/docs/uk/troubleshooting/opencode-connection.mdx new file mode 100644 index 00000000..fe1d4dcf --- /dev/null +++ b/packages/docs/content/docs/uk/troubleshooting/opencode-connection.mdx @@ -0,0 +1,34 @@ +--- +title: Підключення до OpenCode +description: Виправте проблему, коли OpenChamber не підключається до свого сервера OpenCode. +--- + +# Підключення до OpenCode + +Якщо OpenChamber завантажується, але ніяк не виходить за межі стану «OpenCode перезапускається», або чат не відповідає, сервер, із яким він спілкується, недоступний. Пройдіться по цьому. + +## Він застряг на «OpenCode перезапускається» + +- дайте йому хвилину одразу після запуску — цей стан нормальний, поки сервер стартує +- перевірте, чи сервер живий, командою `openchamber status` +- перезапустіть його командою `openchamber restart` +- перегляньте деталі запуску командою `openchamber logs` + +## Ви підключаєтеся до власного сервера + +Якщо ви налаштували OpenChamber на використання наявного сервера, ще раз перевірте налаштування з [OpenCode Server](/uk/opencode-server/): + +- `OPENCODE_HOST` має містити порт, без шляху — наприклад, `http://localhost:4096` +- задайте `OPENCODE_SKIP_START=true`, щоб OpenChamber не запускав ще й свій +- якщо адреса недійсна, OpenChamber ігнорує її й натомість запускає власний сервер — шукайте попередження `[config]` у журналах + +## Усе ще не працює + +- переконайтеся, що версія Node.js — `20` або новіша +- перевстановіть найновіший CLI +- відкрийте `http://localhost:3000` напряму, перш ніж тестувати будь-який тунель чи віддалене посилання + +## Пов'язане + +- [OpenCode Server](/uk/opencode-server/) — як OpenChamber знаходить сервер і керує ним +- [Усунення несправностей](/uk/troubleshooting/) — інші поширені проблеми diff --git a/packages/docs/content/docs/uk/troubleshooting/remote-access.mdx b/packages/docs/content/docs/uk/troubleshooting/remote-access.mdx new file mode 100644 index 00000000..32bdf168 --- /dev/null +++ b/packages/docs/content/docs/uk/troubleshooting/remote-access.mdx @@ -0,0 +1,38 @@ +--- +title: Віддалений доступ +description: Виправляйте тунелі, віддалені інстанси та доступ до OpenChamber з іншого пристрою. +--- + +# Віддалений доступ + +Коли ви не можете дістатися OpenChamber із телефона чи іншої машини, виправлення залежить від того, як ви підключаєтеся. + +## Спершу перевірте базове + +- відкрийте `http://localhost:3000` спочатку на тому самому комп'ютері — якщо це не вдається, то проблема не у віддаленому доступі; див. [Підключення до OpenCode](/uk/troubleshooting/opencode-connection/) +- переконайтеся, що сервер запущений, командою `openchamber status` + +## Посилання тунелю не працює + +- виконайте `openchamber tunnel status --all` +- перезапустіть тунель з того самого інстансу й порту +- перегенеруйте посилання для підключення, якщо попереднє вже було використане + +Повне налаштування див. у [Тунелях](/uk/tunnels/). + +## Віддалений інстанс не підключається (десктоп) + +Коли [віддалений інстанс](/uk/remote-instances/) застрягає, OpenChamber називає крок, який збоїв: + +- **auth** — ваш SSH- чи UI-пароль було відхилено; уведіть його повторно +- **install / start** — OpenChamber не зміг налаштувати чи запустити сервер на віддаленій машині; перевірте вимоги тієї машини +- **forwarding** — з'єднання встановлено, але порт не доходить до вас; спробуйте інший локальний порт + +## За власним сервером + +Якщо ви поставили OpenChamber за зворотним проксі, і він завантажується дивно чи не підключається, див. [Зворотний проксі](/uk/reverse-proxy/). + +## Пов'язане + +- [Тунелі](/uk/tunnels/) · [Віддалені інстанси](/uk/remote-instances/) · [Зворотний проксі](/uk/reverse-proxy/) +- [Безпека](/uk/security/) — захистіть UI перед тим, як відкривати доступ diff --git a/packages/docs/content/docs/uk/troubleshooting/worktrees-git.mdx b/packages/docs/content/docs/uk/troubleshooting/worktrees-git.mdx new file mode 100644 index 00000000..7937db0e --- /dev/null +++ b/packages/docs/content/docs/uk/troubleshooting/worktrees-git.mdx @@ -0,0 +1,35 @@ +--- +title: Worktree та Git +description: Виправляйте поширені проблеми з worktree та git. +--- + +# Worktree та Git + +Проблеми, що виникають із [сесіями worktree](/uk/worktrees/) та [виглядом git](/uk/git/), і як їх усунути. + +## Worktree потребує уваги + +OpenChamber позначає worktree, коли щось не так: + +- **folder missing** — теку worktree видалено чи переміщено поза OpenChamber; приберіть сесію й створіть свіжий worktree +- **detached or unborn branch** — worktree не на звичайній гілці; викачайте його на одну +- **merge, rebase, or cherry-pick in progress** — операцію лишили наполовину завершеною; завершіть або скасуйте її з вигляду git + +## Не вдається створити worktree + +- **branch already exists** — виберіть іншу назву гілки або скористайтеся опцією наявної гілки +- **name already in use** — виберіть іншу назву worktree + +## Генерація коміту чи PR збоїть + +Генерація повідомлення коміту чи опису PR відбувається у вашій активній сесії, тож вам потрібна відкрита сесія з вибраною робочою моделлю. Відкрийте чи виберіть сесію й спробуйте знову. + +## Проблеми зі шляхами SSH чи Windows + +- переконайтеся, що SSH-ключ, який використовує репозиторій, — це той, що заданий у вашій [git-ідентичності](/uk/git-identities/) +- у Windows git використовує шляхи в стилі Unix (як-от `/c/Users/...`) — OpenChamber це обробляє, але власні шляхи до SSH-ключів мають дотримуватися тієї самої форми + +## Пов'язане + +- [Сесії worktree](/uk/worktrees/) — як worktree створюються та видаляються +- [Git-ідентичності](/uk/git-identities/) — задайте правильний ключ та ідентичність для кожного репозиторію diff --git a/packages/docs/content/docs/uk/tunnels.mdx b/packages/docs/content/docs/uk/tunnels.mdx index 89a60f23..00d8142f 100644 --- a/packages/docs/content/docs/uk/tunnels.mdx +++ b/packages/docs/content/docs/uk/tunnels.mdx @@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000 ## Пов'язане +- [Безпека](/uk/security/) — захистіть інтерфейс перед відкриттям доступу +- [PWA та мобільний доступ](/uk/mobile/) — відкривайте OpenChamber з телефона - [Усунення несправностей](/uk/troubleshooting/) — якщо посилання тунелю не працює diff --git a/packages/docs/content/docs/uk/updates.mdx b/packages/docs/content/docs/uk/updates.mdx new file mode 100644 index 00000000..28602623 --- /dev/null +++ b/packages/docs/content/docs/uk/updates.mdx @@ -0,0 +1,31 @@ +--- +title: Оновлення +description: Тримайте OpenChamber оновленим на десктопі, у вебі та VS Code. +--- + +# Оновлення + +Те, як ви оновлюєте OpenChamber, залежить від того, як ви його встановили. У будь-якому разі ви можете перевірити свою поточну версію в **Settings → OpenChamber → About**. + +## Десктопний застосунок + +Десктопний застосунок перевіряє наявність оновлень у релізах GitHub. Коли воно доступне, OpenChamber повідомляє вам, завантажує його, коли ви оберете, і встановлює при наступному перезапуску. Ви завжди керуєте процесом — нічого не встановлюється без вашого схвалення. + +## Веб / CLI + +Якщо ви встановили CLI, оновіть його з **About** кнопками перевірки та оновлення або з терміналу: + +```bash +openchamber update +``` + +OpenChamber визначає, як його було встановлено (npm, pnpm, yarn чи bun), і запускає правильне оновлення за вас. + +## Сервер OpenCode + +OpenChamber та OpenCode оновлюються окремо. Коли доступна нова версія OpenCode, OpenChamber пропонує оновити її й перезапускає сервер після цього. Див. [OpenCode Server](/uk/opencode-server/) про те, як цим сервером керують. + +## Пов'язане + +- [Встановлення](/uk/install/) — як кожен застосунок встановлюється спочатку +- [OpenCode Server](/uk/opencode-server/) — оновлення базового сервера diff --git a/packages/docs/content/docs/uk/usage.mdx b/packages/docs/content/docs/uk/usage.mdx new file mode 100644 index 00000000..0066413b --- /dev/null +++ b/packages/docs/content/docs/uk/usage.mdx @@ -0,0 +1,28 @@ +--- +title: Використання та квоти +description: Відстежуйте, скільки з плану вашого провайдера ви вже використали. +--- + +# Використання та квоти + +Сторінка «Використання» показує, скільки з плану кожного провайдера ви витратили, щоб ви бачили, наскільки близько до ліміту перебуваєте. Відкрийте її в **Settings → Usage**. + +## Що ви бачите + +Для кожного підключеного провайдера OpenChamber показує: + +- скільки з поточного вікна ви використали, у вигляді смужки +- розподіл за моделями +- індикатор темпу, щоб ви могли зрозуміти, чи встигнете вичерпати ліміт + +Ви можете обрати, які провайдери відображаються, і той самий підсумок доступний із випадного меню в заголовку застосунку. + +## Підтримувані провайдери + +Використання працює для провайдерів, які публікують квоту, зокрема Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud та Wafer. + +Провайдер показує використання лише після того, як ви до нього увійшли на сторінці [Провайдери](/uk/providers/). Кільком провайдерам потрібен додатковий крок — наприклад, Ollama Cloud читає файл сесії, який ви налаштовуєте окремо. Якщо провайдер не показує даних, зазвичай це означає, що бракує цих додаткових облікових даних. + +## Пов'язане + +- [Провайдери, моделі та агенти](/uk/providers/) — увійдіть, перш ніж з'явиться використання diff --git a/packages/docs/content/docs/uk/voice.mdx b/packages/docs/content/docs/uk/voice.mdx new file mode 100644 index 00000000..a9d2187e --- /dev/null +++ b/packages/docs/content/docs/uk/voice.mdx @@ -0,0 +1,36 @@ +--- +title: Голосовий режим +description: Говоріть з OpenChamber і слухайте відповіді, зачитані вголос. +--- + +# Голосовий режим + +Голосовий режим дає змогу диктувати повідомлення й слухати відповіді, зачитані вам уголос. Увімкніть його в **Settings → OpenChamber → Voice**. + +## Зачитування відповідей уголос (текст-у-мовлення) + +Виберіть, як озвучуються відповіді: + +- **browser** — вбудовані голоси вашого браузера, без налаштування +- **OpenAI** — голоси OpenAI; вставте свій API-ключ і виберіть голос +- **OpenAI-compatible** — будь-який сервіс, що говорить у форматі OpenAI; уведіть його URL і, якщо потрібно, API-ключ +- **macOS say** — вбудована команда `say`, на Mac'ах, де вона є + +Коли ввімкнено, ви отримуєте кнопку відтворення на повідомленнях, щоб почути їх зачитаними вголос. + +## Диктування повідомлень (мовлення-у-текст) + +Виберіть, як транскрибується ваше мовлення: + +- **browser** — вбудоване розпізнавання вашого браузера, без налаштування +- **server** — OpenAI-сумісний сервіс транскрипції; уведіть його URL і, за потреби, API-ключ +- **on-device** — модель мовлення, що працює у вашому браузері й завантажується при першому використанні + +## Зауваження для телефонів + +Для зачитування відповідей уголос на телефоні опції OpenAI чи OpenAI-compatible найнадійніші — мобільні браузери обмежують вбудовані голоси. + +## Пов'язане + +- [Сповіщення](/uk/notifications/) — отримуйте пінг замість того, щоб слухати +- [Провайдери, моделі та агенти](/uk/providers/) — де ваш ключ OpenAI, можливо, вже зберігається diff --git a/packages/docs/content/docs/uk/worktrees.mdx b/packages/docs/content/docs/uk/worktrees.mdx new file mode 100644 index 00000000..8863e6dc --- /dev/null +++ b/packages/docs/content/docs/uk/worktrees.mdx @@ -0,0 +1,36 @@ +--- +title: Сесії worktree +description: Дайте сесії власну гілку й теку, щоб робота лишалася ізольованою. +--- + +# Сесії worktree + +Сесія worktree працює у власній викачаній копії вашого репозиторію, у власній гілці (git worktree). Це не дає паралельним сесіям заважати файлам одна одної — одна може робити рефакторинг, поки інша виправляє баг, без перемикань туди-сюди. + +## Створення + +1. Відкрийте діалог нового worktree з кнопки вгорі бічної панелі сесій. +2. Виберіть відправну точку: + - **new branch** — назвіть гілку й виберіть, від якої гілки почати + - **existing branch** — викачайте гілку, яка у вас уже є +3. Підтвердьте теку worktree (OpenChamber пропонує одну з назви гілки). +4. Створіть його. + +OpenChamber створює гілку, налаштовує теку й запускає в ній сесію. Ви також можете запустити її прямо із [завдання](/uk/notes-todos-plans/) або [issue чи PR у GitHub](/uk/github/). + +## Повернення роботи + +Коли робота готова, скористайтеся **Integrate** у вигляді Git, щоб перенести коміти worktree на іншу гілку (як-от `main`). Якщо зміна конфліктує, ви можете передати конфлікт агентові на розв'язання. + +## Прибирання + +Видалення чи архівування сесії може прибрати worktree. Ви обираєте, чи також видалити гілку — локальну й віддалену, якщо така є. Нічого не видаляється без вашого запиту. + +## Якщо щось виглядає не так + +Worktree може потребувати уваги, якщо його тека зникла, його гілка в стані detached або злиття чи rebase наполовину завершені. OpenChamber позначає це, щоб ви могли виправити — див. [Worktree та Git](/uk/troubleshooting/worktrees-git/). + +## Пов'язане + +- [Multi-run](/uk/multi-run/) — запускайте багато сесій worktree одночасно +- [Робочі процеси Git і GitHub](/uk/git/) — комітьте та інтегруйте зсередини OpenChamber diff --git a/packages/docs/content/docs/updates.mdx b/packages/docs/content/docs/updates.mdx new file mode 100644 index 00000000..6129deb8 --- /dev/null +++ b/packages/docs/content/docs/updates.mdx @@ -0,0 +1,31 @@ +--- +title: Updates +description: Keep OpenChamber up to date on desktop, web, and VS Code. +--- + +# Updates + +How you update OpenChamber depends on how you installed it. In every case you can check your current version at **Settings → OpenChamber → About**. + +## Desktop app + +The desktop app checks for updates against GitHub releases. When one is available, OpenChamber tells you, downloads it when you choose, and installs it on the next restart. You're always in control — nothing installs without your say-so. + +## Web / CLI + +If you installed the CLI, update it from **About** with the check and update buttons, or from the terminal: + +```bash +openchamber update +``` + +OpenChamber detects how it was installed (npm, pnpm, yarn, or bun) and runs the right update for you. + +## The OpenCode server + +OpenChamber and OpenCode update separately. When a new OpenCode version is available, OpenChamber offers to update it and restarts the server afterward. See [OpenCode Server](/opencode-server/) for how that server is managed. + +## Related + +- [Install](/install/) — how each app is installed in the first place +- [OpenCode Server](/opencode-server/) — updating the underlying server diff --git a/packages/docs/content/docs/usage.mdx b/packages/docs/content/docs/usage.mdx new file mode 100644 index 00000000..64315ca6 --- /dev/null +++ b/packages/docs/content/docs/usage.mdx @@ -0,0 +1,28 @@ +--- +title: Usage & Quotas +description: Track how much of your provider plan you've used. +--- + +# Usage & Quotas + +The Usage page shows how much of each provider's plan you've used, so you can see how close you are to a limit. Open it at **Settings → Usage**. + +## What you see + +For each connected provider, OpenChamber shows: + +- how much of the current window you've used, as a bar +- a breakdown by model +- a pace indicator, so you can tell if you're on track to run out + +You can choose which providers appear, and the same summary is available from a dropdown in the app header. + +## Supported providers + +Usage works for the providers that publish a quota, including Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud, and Wafer. + +A provider only shows usage once you've signed in to it on the [Providers](/providers/) page. A few providers need an extra step — for example, Ollama Cloud reads a session file you set up separately. If a provider shows no data, it usually means that extra credential is missing. + +## Related + +- [Providers, Models & Agents](/providers/) — sign in before usage appears diff --git a/packages/docs/content/docs/voice.mdx b/packages/docs/content/docs/voice.mdx new file mode 100644 index 00000000..5ac3372d --- /dev/null +++ b/packages/docs/content/docs/voice.mdx @@ -0,0 +1,36 @@ +--- +title: Voice Mode +description: Speak to OpenChamber and hear replies read aloud. +--- + +# Voice Mode + +Voice mode lets you dictate messages and have replies read back to you. Turn it on at **Settings → OpenChamber → Voice**. + +## Reading replies aloud (text-to-speech) + +Pick how replies are spoken: + +- **browser** — your browser's built-in voices, no setup +- **OpenAI** — OpenAI's voices; paste your API key and pick a voice +- **OpenAI-compatible** — any service that speaks the OpenAI format; enter its URL and, if it needs one, an API key +- **macOS say** — the built-in `say` command, on Macs that have it + +Once on, you get a play button on messages to hear them read aloud. + +## Dictating messages (speech-to-text) + +Pick how your speech is transcribed: + +- **browser** — your browser's built-in recognition, no setup +- **server** — an OpenAI-compatible transcription service; enter its URL and, if needed, an API key +- **on-device** — a speech model that runs in your browser and downloads the first time you use it + +## A note for phones + +For reading replies aloud on a phone, the OpenAI or OpenAI-compatible options are the most reliable — mobile browsers limit the built-in voices. + +## Related + +- [Notifications](/notifications/) — get pinged instead of listening +- [Providers, Models & Agents](/providers/) — where your OpenAI key may already live diff --git a/packages/docs/content/docs/worktrees.mdx b/packages/docs/content/docs/worktrees.mdx new file mode 100644 index 00000000..b83c6496 --- /dev/null +++ b/packages/docs/content/docs/worktrees.mdx @@ -0,0 +1,36 @@ +--- +title: Worktree Sessions +description: Give a session its own branch and folder so work stays isolated. +--- + +# Worktree Sessions + +A worktree session runs in its own checked-out copy of your repo, on its own branch (a git worktree). That keeps parallel sessions from stepping on each other's files — one can refactor while another fixes a bug, with no switching back and forth. + +## Create one + +1. Open the new-worktree dialog from the button at the top of the session sidebar. +2. Choose a starting point: + - **new branch** — name the branch and pick which branch to start from + - **existing branch** — check out a branch you already have +3. Confirm the worktree folder (OpenChamber suggests one from the branch name). +4. Create it. + +OpenChamber makes the branch, sets up the folder, and starts a session in it. You can also kick one off straight from a [todo](/notes-todos-plans/) or a [GitHub issue or PR](/github/). + +## Bring the work back + +When the work is good, use **Integrate** in the Git view to bring the worktree's commits onto another branch (like `main`). If a change conflicts, you can hand the conflict to the agent to resolve. + +## Clean up + +Deleting or archiving the session can remove the worktree. You choose whether to also delete the branch — local, and remote if there is one. Nothing is deleted without you asking. + +## If something looks off + +A worktree can need attention if its folder went missing, its branch is in a detached state, or a merge or rebase is half-finished. OpenChamber flags these so you can fix them — see [Worktrees & Git](/troubleshooting/worktrees-git/). + +## Related + +- [Multi-run](/multi-run/) — launch many worktree sessions at once +- [Git & GitHub Workflows](/git/) — commit and integrate from inside OpenChamber diff --git a/packages/docs/content/docs/zh-cn/commands-snippets.mdx b/packages/docs/content/docs/zh-cn/commands-snippets.mdx new file mode 100644 index 00000000..4a2cd75a --- /dev/null +++ b/packages/docs/content/docs/zh-cn/commands-snippets.mdx @@ -0,0 +1,39 @@ +--- +title: 命令与代码片段 +description: 为聊天创建可复用的斜杠命令和文本片段。 +--- + +# 命令与代码片段 + +命令和代码片段都能让你免于重复输入相同的内容。命令是你用 `/` 触发的完整提示词；代码片段是你用 `#` 插入到消息中的文本片段。 + +## 命令 + +命令是你用斜杠运行的已保存提示词，比如 `/review`。在 **Settings → Commands** 中管理它们。 + +1. 打开 **Settings → Commands** 并创建一个命令。 +2. 给它一个名称、一段描述，以及它应发送的提示词文本。 +3. 可选地将它固定到特定的智能体或模型。 +4. 选择个人或项目范围。 + +在聊天中，将 `/` 作为消息的**第一个**字符即可调出命令，然后选择一个。你的文本可以使用占位符： + +- `$ARGUMENTS` — 你在命令后输入的任何内容 +- `@filename` — 插入某个文件的内容 +- `` !`command` `` — 插入某个 shell 命令的输出 + +内置的 `init` 和 `review` 命令可以重置，但不能删除。 + +## 代码片段 + +代码片段是你用井号在行内引用的可复用文本，比如 `#signoff`。在 **Settings → Snippets** 中管理它们。 + +1. 打开 **Settings → Snippets** 并创建一个代码片段。 +2. 给它一个名称以及它所代表的文本。如果你想要多个触发词，可以添加别名。 +3. 选择个人或项目范围。 + +在聊天中，输入 `#` 并选择一个代码片段。OpenChamber 会在发送前替换为完整文本。 + +## 相关内容 + +- [Skills](/zh-cn/skills/) — 按需加载更大的指令集 diff --git a/packages/docs/content/docs/zh-cn/context.mdx b/packages/docs/content/docs/zh-cn/context.mdx new file mode 100644 index 00000000..0e782375 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/context.mdx @@ -0,0 +1,38 @@ +--- +title: 上下文 +description: 查看会话占用了模型多少记忆。 +--- + +# 上下文 + +每个模型一次只能容纳一段对话中有限的内容 — 即它的上下文。OpenChamber 会显示上下文的占满程度，让你知道会话何时接近上限，以及回复何时可能开始丢弃较早的细节。 + +## 快速指示器 + +聊天时，一个小仪表会显示已使用上下文的百分比。随着上下文被填满，它会改变颜色： + +- 绿色 — 空间充足 +- 黄色 — 渐满（约四分之三） +- 红色 — 接近占满 + +将鼠标悬停在它上面（在移动端则点按它）可查看准确的 token 计数。 + +## 完整上下文面板 + +打开右侧边栏中的 **Context** 标签页，可更全面地了解当前会话： + +- 正在使用的模型，以及会话开始的时间 +- 总 token 数与模型上限的对比 +- 消息和成本总计 +- 上一条回复的 token 细分 +- 大致区分出占用上下文的内容（你的消息、智能体的消息、工具输出） + +该细分是估算值，而非精确计数 — 用它来发现是什么在填满窗口，而不是用于计费。 + +## 占满时该怎么办 + +为新任务开启一个新会话，而不要让单个会话无限增长。更短的上下文更快，并能让模型保持专注。 + +## 相关内容 + +- [项目](/zh-cn/projects/) — 会话按项目分组 diff --git a/packages/docs/content/docs/zh-cn/desktop-browser.mdx b/packages/docs/content/docs/zh-cn/desktop-browser.mdx new file mode 100644 index 00000000..78c61ef4 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/desktop-browser.mdx @@ -0,0 +1,22 @@ +--- +title: 桌面浏览器 +description: 在桌面应用内部浏览任意页面，并提供检查和控制台捕获功能。 +--- + +# 桌面浏览器 + +桌面应用内置了浏览器，因此你可以在聊天旁边直接打开任意页面、指向元素来询问相关问题，并捕获页面的控制台。从应用标题栏的地球按钮打开它。 + +> 桌面浏览器是一项**仅限桌面**的功能。在网页端，[预览](/zh-cn/preview/) 面板为你的本地开发服务器提供相同的检查与控制台工具。 + +## 检查与标注 + +开启 **inspect** 并点击页面上的任意元素。OpenChamber 会捕获关于它的说明 — 它是什么、它的样式、它所处的位置，以及一张截图 — 并将其附加到你的聊天消息中。这是告诉智能体“就这个元素，就在这里”的最快方式。 + +## 控制台捕获 + +浏览器会收集页面的控制台输出 — 错误、警告和日志 — 因此你无需打开开发者工具即可筛选和阅读它。 + +## 相关内容 + +- [预览与开发服务器](/zh-cn/preview/) — 为你的本地开发服务器提供相同的工具 diff --git a/packages/docs/content/docs/zh-cn/git-identities.mdx b/packages/docs/content/docs/zh-cn/git-identities.mdx new file mode 100644 index 00000000..eb078d02 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/git-identities.mdx @@ -0,0 +1,30 @@ +--- +title: Git 身份 +description: 在每个仓库中以正确的姓名和邮箱进行提交。 +--- + +# Git 身份 + +git 身份是你的提交所署名的姓名和邮箱。如果你在个人仓库和工作仓库之间往返，你可以保存多个身份并为每个仓库应用正确的那个，而不必依赖单一的全局设置。在 **Settings → Git** 中管理它们。 + +## 添加身份 + +1. 打开 **Settings → Git** 并选择 **New**。 +2. 输入用于提交的 **name** 和 **email**。 +3. 选择它如何与远程进行鉴权： + - **SSH** — 让它指向一个 SSH 密钥 + - **token** — 使用某个主机已保存的凭证 +4. 可选地给它一个颜色和图标，以便易于识别。 + +你系统的全局身份也会显示，为只读。 + +## 为仓库应用身份 + +应用身份会将它写入该仓库的 **local** git 配置 — 它只影响该仓库，不影响你的全局设置。SSH 身份还会设置 SSH 命令以使用你的密钥；token 身份会为该主机设置凭证存储。 + +你可以导入 OpenChamber 从你现有 git 凭证中发现的身份，并将它们保存为 token 身份。 + +## 相关内容 + +- [Git 与 GitHub 工作流](/zh-cn/git/) — 使用你设置的身份进行提交 +- [GitHub Issue 与 PR](/zh-cn/github/) — 连接 GitHub 账号以使用 PR diff --git a/packages/docs/content/docs/zh-cn/git.mdx b/packages/docs/content/docs/zh-cn/git.mdx new file mode 100644 index 00000000..491133c3 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/git.mdx @@ -0,0 +1,41 @@ +--- +title: Git 与 GitHub 工作流 +description: 无需离开 OpenChamber 即可暂存、提交和管理分支。 +--- + +# Git 与 GitHub 工作流 + +OpenChamber 内置了 git 视图，让你可以审阅变更、提交并管理分支，而无需切换到终端。从右侧边栏的 **Git** 标签页打开它。 + +## 审阅与提交 + +git 视图将你的变更分为 **staged** 和 **unstaged**： + +- 点击文件的 **+** 可暂存它，或点击 **−** 取消暂存 +- 一次性暂存或取消暂存某个分组中的所有内容 +- 点击文件可查看它的 diff + +然后编写提交信息并提交。你可以让 OpenChamber 从你已暂存的变更中 **生成提交信息** — 它使用当前会话的模型，因此你需要打开一个会话。 + +## 分支与历史 + +git 视图也涵盖了 git 日常的其余操作： + +- 创建、切换、重命名和删除分支 +- 推送、拉取和获取 +- 浏览历史和每次提交的 diff +- 暂存（stash）和恢复变更 + +## 拉取请求 + +连接 GitHub（参阅 [GitHub Issue 与 PR](/zh-cn/github/)），**PR** 标签页让你可以打开拉取请求、更新它、将其标记为就绪或合并它 — 并以与提交信息相同的方式生成它的标题和描述。 + +## 处理冲突 + +如果一次合并、变基或集成遇到冲突，OpenChamber 会显示卡住的内容并让你解决它 — 包括把它交给智能体。 + +## 相关内容 + +- [GitHub Issue 与 PR](/zh-cn/github/) — 连接 GitHub 并从 issue 开始工作 +- [Worktree 会话](/zh-cn/worktrees/) — 在独立文件夹中隔离一个分支 +- [Git 身份](/zh-cn/git-identities/) — 在每个仓库中以正确的身份提交 diff --git a/packages/docs/content/docs/zh-cn/github.mdx b/packages/docs/content/docs/zh-cn/github.mdx new file mode 100644 index 00000000..19bd4476 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/github.mdx @@ -0,0 +1,34 @@ +--- +title: GitHub Issue 与 PR +description: 连接 GitHub 并从 issue 和拉取请求开始会话。 +--- + +# GitHub Issue 与 PR + +连接你的 GitHub 账号，OpenChamber 就可以拉取 issue 和拉取请求、直接从其中一个开始会话，并为你打开或更新 PR。 + +## 连接 GitHub + +1. 打开 **Settings → Git**。 +2. 在 GitHub 下，选择 **Connect**。OpenChamber 会显示一个链接和一个短码。 +3. 打开链接，输入短码并批准。 + +连接后，你的账号会显示在 GitHub 部分下。你可以连接多个账号并在它们之间切换，或随时断开连接。 + +## 从 issue 或 PR 开始工作 + +当你在连接了 GitHub 的情况下创建 [worktree 会话](/zh-cn/worktrees/) 时，你可以选择 **Start from GitHub issue/PR**： + +- 选择一个 **issue**，OpenChamber 会以它命名分支，并以该 issue 及其评论作为第一条消息打开会话 +- 选择一个 **pull request**，它会检出该 PR 的分支；你可以包含 PR 的 diff，以便智能体掌握完整的变更 + +这会让你直接进入一个已经加载好上下文的会话。 + +## 打开并管理拉取请求 + +在 [git 视图](/zh-cn/git/) 的 **PR** 标签页中，你可以创建拉取请求、更新它、将草稿标记为就绪或合并它。OpenChamber 可以从你的变更生成 PR 标题和描述。 + +## 相关内容 + +- [Git 与 GitHub 工作流](/zh-cn/git/) — 提交和管理分支 +- [Worktree 会话](/zh-cn/worktrees/) — issue 和 PR 会话从这里开始 diff --git a/packages/docs/content/docs/zh-cn/index.mdx b/packages/docs/content/docs/zh-cn/index.mdx index 6e4f390d..31848393 100644 --- a/packages/docs/content/docs/zh-cn/index.mdx +++ b/packages/docs/content/docs/zh-cn/index.mdx @@ -20,6 +20,13 @@ OpenChamber 是围绕 OpenCode（在你终端中运行的 AI 编程智能体） - [隧道](/zh-cn/tunnels/) - [问题排查](/zh-cn/troubleshooting/) +## 探索 + +- [项目](/zh-cn/projects/) 与 [Worktree 会话](/zh-cn/worktrees/) — 组织并隔离你的工作 +- [提供商、模型与智能体](/zh-cn/providers/) — 连接 OpenCode 并选择模型 +- [Git 与 GitHub 工作流](/zh-cn/git/) — 提交、审查并创建 PR +- [安全](/zh-cn/security/) 与 [隧道](/zh-cn/tunnels/) — 保护并访问你的实例 + ## OpenChamber 用于什么 OpenChamber 面向 AI 编程中那些受益于控制中枢的部分：为会话分支、审查代码差异、管理终端、观察工具进度、运行项目操作，并在智能体工作时让整个面板尽收眼底。 diff --git a/packages/docs/content/docs/zh-cn/magic-prompts.mdx b/packages/docs/content/docs/zh-cn/magic-prompts.mdx new file mode 100644 index 00000000..65d17398 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/magic-prompts.mdx @@ -0,0 +1,26 @@ +--- +title: Magic Prompts +description: 自定义 OpenChamber 自动化流程背后的内置提示词。 +--- + +# Magic Prompts + +每当 OpenChamber 自动做某件事时 — 编写提交信息、起草 PR、审阅 issue、解决冲突、总结会话 — 它都会在幕后使用内置的提示词。Magic Prompts 就是你阅读和重写这些提示词的地方。在 **Settings → Magic Prompts** 中打开它。 + +日常使用并不需要本页。当你想让某个流程表现得有所不同时再用它 — 比如让提交信息采用某种特定风格。 + +## 编辑提示词 + +1. 打开 **Settings → Magic Prompts**。 +2. 从侧边栏的分组中选择一个提示词 — Git、GitHub、Planning 和 Session。 +3. 编辑文本并保存。 + +有些提示词有一个可见部分（你会看到的消息）和一个指令部分（对智能体隐藏的引导）。提示词可以包含 OpenChamber 会填入的 `{{placeholders}}`，比如 diff 或 issue 标题 — 请保留它们原样。 + +## 重置 + +改主意了？每个提示词都有 **reset to default**，如果你想在所有地方重新开始，还有一个 **reset all**。 + +## 相关内容 + +- [Git 与 GitHub 工作流](/zh-cn/git/) — 其中许多提示词为 git 流程提供动力 diff --git a/packages/docs/content/docs/zh-cn/mcp.mdx b/packages/docs/content/docs/zh-cn/mcp.mdx new file mode 100644 index 00000000..43599b53 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/mcp.mdx @@ -0,0 +1,30 @@ +--- +title: MCP Servers +description: 添加 MCP 服务器，为智能体提供额外工具。 +--- + +# MCP Servers + +MCP 服务器为你的智能体提供额外的工具 — 比如搜索数据库、调用 API，或读取你使用的某个服务。在 **Settings → MCP** 中添加它们。 + +## 添加服务器 + +1. 打开 **Settings → MCP**。 +2. 添加一个服务器并选择它的类型： + - **local** — OpenChamber 在你的机器上运行一个命令。你需要提供要运行的命令，以及（如有需要）环境变量。 + - **remote** — OpenChamber 连接到由他人托管的 URL。你需要提供该 URL 以及它所需的任何请求头（例如鉴权令牌）。 +3. 保存。服务器默认开启；你可以将其关闭而不删除它。 + +## 适用范围 + +添加服务器时选择适用范围： + +- **personal** — 在每个项目中都可用 +- **project** — 仅在当前项目中可用，并与项目的其他设置一起保存 + +服务器名称使用小写字母、数字、连字符和下划线。 + +## 相关内容 + +- [提供商、模型与智能体](/zh-cn/providers/) — 先连接一个模型 +- [Skills](/zh-cn/skills/) — 另一种扩展智能体能力的方式 diff --git a/packages/docs/content/docs/zh-cn/mobile.mdx b/packages/docs/content/docs/zh-cn/mobile.mdx new file mode 100644 index 00000000..e03cf02c --- /dev/null +++ b/packages/docs/content/docs/zh-cn/mobile.mdx @@ -0,0 +1,31 @@ +--- +title: PWA 与移动访问 +description: 将 OpenChamber 安装为应用，并在手机上使用它。 +--- + +# PWA 与移动访问 + +OpenChamber 网页应用可以像手机应用一样安装（即 PWA），因此你可以把它放在主屏幕上并全屏使用。配合 [隧道](/zh-cn/tunnels/)，你就可以从任何地方查看某个会话。 + +## 安装它 + +OpenChamber 使用你浏览器的内置安装功能，因此没有单独的下载： + +- **桌面浏览器** — 使用地址栏中的 **Install** 选项 +- **iPhone/iPad（Safari）** — 分享 → **Add to Home Screen** +- **Android（Chrome）** — 菜单 → **Install app** / **Add to Home Screen** + +安装后，它会在自己的窗口中打开，没有浏览器外框。 + +## 从手机访问它 + +要在服务器运行于你电脑上时在手机上打开 OpenChamber，请启动一个 [隧道](/zh-cn/tunnels/)，并在手机上打开链接（或扫描二维码）。每当你这样做时，请使用一个强 [UI 密码](/zh-cn/security/)。 + +## 移动端设置 + +在 **Settings → OpenChamber** 下，有几个选项可以调整移动端和已安装应用的体验 — 应用的安装名称、屏幕方向，以及屏幕键盘的行为方式。 + +## 相关内容 + +- [隧道](/zh-cn/tunnels/) — 从另一个网络访问你的实例 +- [安全](/zh-cn/security/) — 在公开 UI 之前保护它 diff --git a/packages/docs/content/docs/zh-cn/multi-run.mdx b/packages/docs/content/docs/zh-cn/multi-run.mdx new file mode 100644 index 00000000..7847240d --- /dev/null +++ b/packages/docs/content/docs/zh-cn/multi-run.mdx @@ -0,0 +1,34 @@ +--- +title: Multi-run +description: 一次性在多个模型或会话上运行相同的提示词。 +--- + +# Multi-run + +Multi-run 从一个表单启动多个会话 — 适合用不同的模型尝试同一个任务并比较结果。从会话侧边栏顶部的按钮打开它。 + +## 启动一次 multi-run + +1. 打开 multi-run 启动器。 +2. 选择项目并为运行组命名。 +3. 编写提示词并选择要用来运行它的模型（每组最多五个）。 +4. 选择是否 **isolate runs**。 +5. 启动。 + +每个模型都会获得自己的会话，它们都以你的提示词开始。 + +## 隔离运行 + +开启 **isolate runs** 可以为每次运行提供它自己的 [worktree](/zh-cn/worktrees/) 和分支，这样它们就绝不会触碰相同的文件。这需要一个 git 仓库 — 对于不是 git 仓库的文件夹，它会自动关闭。选择运行从哪个分支开始。 + +关闭隔离后，每次运行都是项目文件夹中的一个普通会话。 + +## 比较结果 + +每次运行都是一个普通会话，你可以打开、阅读，并保留或丢弃它。如果你启动多个运行是为了比较不同方案，可以并排审阅它们，并把最好的那个推进下去。 + +如果单次运行启动失败，其余的仍会启动 — 你只会看到比请求数量更少的会话。 + +## 相关内容 + +- [Worktree 会话](/zh-cn/worktrees/) — 隔离在底层如何工作 diff --git a/packages/docs/content/docs/zh-cn/notes-todos-plans.mdx b/packages/docs/content/docs/zh-cn/notes-todos-plans.mdx new file mode 100644 index 00000000..b00d0948 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/notes-todos-plans.mdx @@ -0,0 +1,37 @@ +--- +title: 项目笔记、待办与计划 +description: 为每个项目保留笔记、待办列表和已保存的计划。 +--- + +# 项目笔记、待办与计划 + +每个项目都有自己的草稿空间，用于存放笔记、待办列表和已保存的计划。它们属于项目，而不属于任何单个会话，因此当你在会话之间切换时它们会一直保留。在右侧边栏的 **Context** 标签页中可以找到它们（在移动端是一个专用标签页）。 + +## 笔记 + +一个自由格式的笔记框，用于记录任何你想记住的关于项目的内容。它会在你输入时自动保存。 + +## 待办 + +一个简单的清单。添加条目、勾选完成、通过拖动重新排序，并清除已完成的条目。 + +每个待办都有一个 **send** 菜单，让你可以把它交给智能体： + +- 发送到当前会话 +- 用它开启一个新会话 +- 用它开启一个新的 [worktree 会话](/zh-cn/worktrees/)（仅当项目是 git 仓库时） + +## 计划 + +一个用于将较长的计划保存为文件的地方。你可以： + +- 从 Markdown 或文本文件导入计划 +- 打开一个计划在侧面板中阅读 +- 删除你不再需要的计划 + +完成后你应该会回到 Context 标签页，并看到笔记已保存、待办已勾选或计划已列出 — 这就是它生效的标志。 + +## 相关内容 + +- [Worktree 会话](/zh-cn/worktrees/) — 在独立分支中运行某个待办 +- [项目](/zh-cn/projects/) — 这些内容属于活动项目 diff --git a/packages/docs/content/docs/zh-cn/notifications.mdx b/packages/docs/content/docs/zh-cn/notifications.mdx new file mode 100644 index 00000000..121e6766 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/notifications.mdx @@ -0,0 +1,34 @@ +--- +title: 通知 +description: 在会话需要你或完成时收到提醒。 +--- + +# 通知 + +通知会在有事情需要你关注时告诉你，这样你就不必盯着屏幕 — 会话完成了、遇到错误、提出了问题，或需要权限来做某件事。在 **Settings → OpenChamber → Notifications** 中设置它们。 + +## 开启它们 + +1. 打开 **Settings → OpenChamber → Notifications**。 +2. 当你的浏览器或系统询问时，允许通知。 +3. 选择你想被告知哪些事项： + - 会话**完成** + - 会话遇到**错误** + - 会话**提出问题** + - 会话需要**权限** + - **子任务**完成 + +## 它们如何送达你 + +- 在**桌面端**，你会收到原生系统通知 +- 在**浏览器或已安装的应用**中，你会收到网页推送通知，因此即使标签页在后台它们也能送达 + +设置为自动接受的会话不会用权限通知来打扰你。 + +## 自定义措辞 + +每种通知都有一个标题和消息模板，你可以编辑它们，使用诸如智能体名称和模型之类的字段。还有一个对最后一条消息包含多少内容的限制，以使通知保持简短。 + +## 相关内容 + +- [语音模式](/zh-cn/voice/) — 改为听回复被朗读出来 diff --git a/packages/docs/content/docs/zh-cn/opencode-server.mdx b/packages/docs/content/docs/zh-cn/opencode-server.mdx new file mode 100644 index 00000000..b384ba4b --- /dev/null +++ b/packages/docs/content/docs/zh-cn/opencode-server.mdx @@ -0,0 +1,54 @@ +--- +title: OpenCode Server +description: 将 OpenChamber 连接到本地或远程的 OpenCode 服务器。 +--- + +# OpenCode Server + +OpenChamber 运行在 OpenCode 服务器之上。默认情况下，它会为你启动一个，所以你无需做任何事。只有当你想让 OpenChamber 指向一个你已经运行的服务器，或者管理它所启动的服务器时，才需要本页内容。 + +## OpenChamber 如何查找服务器 + +OpenChamber 启动时，会按以下顺序查找服务器： + +1. 复用它已经启动的服务器 +2. 如果你指定了外部服务器，则连接到它（见下文） +3. 在默认端口（`4096`）上自动检测服务器 +4. 否则，启动并管理它自己的服务器 + +如果没有进行任何配置，第 4 步会自动发生，你就可以开始运行了。 + +## 连接到你已经运行的服务器 + +在启动 OpenChamber 之前设置这些变量： + +```bash +OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber +``` + +- `OPENCODE_HOST` — 你的 OpenCode 服务器的完整地址，包括端口（类似 `http://localhost:4096` 这样的值）。末尾不能带路径。 +- `OPENCODE_SKIP_START=true` — 告诉 OpenChamber 不要启动它自己的服务器。 + +如果你只需要更改端口，请设置 `OPENCODE_PORT` 而不是 `OPENCODE_HOST`。 + +如果 `OPENCODE_HOST` 缺少端口或带有路径，OpenChamber 会忽略它并回退到启动自己的服务器。如果你期望的连接没有发生，请留意启动日志中的 `[config]` 警告。 + +## 从 CLI 管理服务器 + +```bash +openchamber status +openchamber logs +openchamber restart +openchamber stop +``` + +单独运行 `openchamber` 会在后台启动服务器。添加 `--foreground` 可以让它保持附加在你的终端上。 + +## “OpenCode is restarting” + +当服务器正在启动或重启时，OpenChamber 会显示 “OpenCode is restarting” 状态，并暂停请求直到服务器就绪。这在启动或重启后立即出现是正常的。如果它一直无法消失，请参阅 [OpenCode 连接](/zh-cn/troubleshooting/opencode-connection/)。 + +## 相关内容 + +- [提供商、模型与智能体](/zh-cn/providers/) — 设置服务器要与之通信的对象 +- [OpenCode 连接](/zh-cn/troubleshooting/opencode-connection/) — 如果无法连接 diff --git a/packages/docs/content/docs/zh-cn/preview.mdx b/packages/docs/content/docs/zh-cn/preview.mdx new file mode 100644 index 00000000..b2d95604 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/preview.mdx @@ -0,0 +1,32 @@ +--- +title: 预览与开发服务器 +description: 在 OpenChamber 内部打开正在运行的开发服务器。 +--- + +# 预览与开发服务器 + +当你启动开发服务器时，OpenChamber 可以直接在应用内部打开它，而不是在单独的浏览器标签页中 — 这样你就可以在聊天旁边查看你的站点、捕获它的控制台，并指向元素来询问相关问题。 + +## 打开预览 + +OpenChamber 会监视终端输出中的本地地址（像 Vite、Next.js 或 Astro 这类工具打印的 `Local:` 行）。当它发现一个时： + +- 终端中会出现一个 **Open preview** 按钮 +- 一个开启了自动打开的 [项目操作](/zh-cn/project-actions/) 会为你打开它 +- 聊天消息中的本地链接也可以打开它 + +站点会在侧面板中加载。只有本地地址（在你自己的机器上）才能被预览。 + +## 控制台与检查 + +在预览面板中你可以： + +- 查看页面的**控制台** — 错误、警告和日志，可按你喜欢的方式筛选 +- 开启 **inspect**，点击任意元素，并将关于它的说明 — 选择器、样式、位置和一张截图 — 直接发送到聊天 + +这是告诉智能体“就这个按钮，这里”而无需描述它的最快方式。 + +## 相关内容 + +- [项目操作](/zh-cn/project-actions/) — 启动服务器时自动打开它 +- [桌面浏览器](/zh-cn/desktop-browser/) — 在桌面端为任意页面提供相同的工具 diff --git a/packages/docs/content/docs/zh-cn/project-actions.mdx b/packages/docs/content/docs/zh-cn/project-actions.mdx new file mode 100644 index 00000000..8da9bf17 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/project-actions.mdx @@ -0,0 +1,28 @@ +--- +title: 项目操作 +description: 保存你经常运行的命令，一键启动它们。 +--- + +# 项目操作 + +项目操作是一个你保存一次、点击即可运行的 shell 命令 — 你的开发服务器、一次构建、一次测试运行。每个项目都保留自己的列表。在 **Settings → Projects → Project Actions** 中设置它们。 + +## 添加操作 + +1. 打开 **Settings → Projects** 并找到 **Project Actions** 部分。 +2. 添加一个操作，给它一个名称，选择一个图标，并输入要运行的命令。 +3. 保存。 + +如果某个命令只在特定操作系统上才有意义，你可以将该操作限制在某些操作系统上。 + +## 运行操作 + +操作位于应用标题栏的一个菜单中。点击其中一个，OpenChamber 就会在你项目文件夹的终端中运行它，并将你切换到终端视图，让你可以观察输出。从同一菜单可以停止它。 + +## 自动打开开发服务器 + +为一个启动服务器的操作开启 **auto-open URL**。OpenChamber 会监视输出中的本地地址并提议打开它 — 参阅 [预览与开发服务器](/zh-cn/preview/)。在桌面端，你还可以通过 SSH 端口转发来路由它。 + +## 相关内容 + +- [预览与开发服务器](/zh-cn/preview/) — 在 OpenChamber 内部打开正在运行的开发服务器 diff --git a/packages/docs/content/docs/zh-cn/project-icons.mdx b/packages/docs/content/docs/zh-cn/project-icons.mdx new file mode 100644 index 00000000..618c3654 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/project-icons.mdx @@ -0,0 +1,20 @@ +--- +title: 项目图标 +description: 为每个项目设置一个易于辨认的图标。 +--- + +# 项目图标 + +项目图标让你一眼就能区分各个项目。OpenChamber 会尝试为你查找一个，你也始终可以设置自己的。在 **Settings → Projects** 中管理它。 + +## 自动发现 + +当你添加项目时，OpenChamber 会在其中查找 `favicon` 文件，并将它用作项目的图标。如果你的仓库已经附带了 favicon，图标通常会自动出现 — 无需任何操作。 + +## 设置你自己的 + +打开 **Settings → Projects** 并上传一张图片（PNG、JPEG 或 SVG，最大 5 MB）。自定义图片的优先级高于自动发现的图片。你也可以改为选择一种颜色，或移除图片以回退到自动发现。 + +## 相关内容 + +- [项目](/zh-cn/projects/) — 命名、设色并组织你的项目 diff --git a/packages/docs/content/docs/zh-cn/projects.mdx b/packages/docs/content/docs/zh-cn/projects.mdx new file mode 100644 index 00000000..4d4bf900 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/projects.mdx @@ -0,0 +1,34 @@ +--- +title: 项目 +description: 将你的工作组织成项目并在它们之间切换。 +--- + +# 项目 + +项目是你计算机上一个由 OpenChamber 追踪的文件夹 — 通常是一个代码库。切换项目会切换智能体工作所在的文件夹，以及该项目的会话和设置。 + +## 添加项目 + +你可以从几个地方添加项目： + +- 命令面板中的 **Add project** 条目 +- 会话侧边栏顶部的 **+** 按钮 +- 选择目录时的文件夹浏览器 + +将它指向一个文件夹，OpenChamber 就会记住它。名称来自文件夹；你之后可以更改它。 + +## 切换项目 + +从侧边栏选择一个项目使其成为活动项目。一切 — 会话、git、笔记 — 都会跟随你打开的项目。 + +## 让项目易于辨认 + +打开 **Settings → Projects** 为项目设置自定义名称、颜色或图标。OpenChamber 会尝试自动查找图标 — 参阅 [项目图标](/zh-cn/project-icons/)。 + +> 在 VS Code 中，OpenChamber 始终使用你打开的文件夹作为唯一的项目，因此没有要添加或切换的内容。Projects 设置页面在那里是隐藏的。 + +## 相关内容 + +- [项目笔记、待办与计划](/zh-cn/notes-todos-plans/) — 为每个项目保留工作笔记 +- [项目操作](/zh-cn/project-actions/) — 保存你经常运行的命令 +- [上下文](/zh-cn/context/) — 查看会话占用了模型多少记忆 diff --git a/packages/docs/content/docs/zh-cn/providers.mdx b/packages/docs/content/docs/zh-cn/providers.mdx new file mode 100644 index 00000000..8e92afd0 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/providers.mdx @@ -0,0 +1,49 @@ +--- +title: 提供商、模型与智能体 +description: 连接 AI 提供商、选择模型并设置智能体。 +--- + +# 提供商、模型与智能体 + +在 OpenChamber 能做任何事之前，它至少需要连接一个 AI 提供商。本页介绍如何连接提供商、选择模型以及定制智能体。 + +## 连接提供商 + +1. 打开 **Settings → Providers**。 +2. 打开 **Add provider** 菜单，选择一个尚未连接的提供商。 +3. 根据提供商的不同，通过以下两种方式之一登录： + - **API 密钥** — 粘贴你的密钥并保存。 + - **登录（设备流程）** — OpenChamber 会显示一个链接和一个短码。打开链接，输入短码并批准。OpenChamber 会自行完成连接。 + +当提供商显示为已连接时，它的模型就会在聊天中可用。 + +要断开连接，请打开该提供商并选择移除其登录。 + +## 选择模型 + +你在工作的地方选择模型： + +- 在聊天中，使用消息栏中的模型选择器为该会话设置提供商和模型 +- 按智能体设置默认模型（见下文） + +## 设置智能体 + +智能体是一个命名的配置 — 包括一个模型、一种个性，以及它被允许做的事。 + +1. 打开 **Settings → Agents**。 +2. 选择一个智能体，或创建一个新的。 +3. 编辑以下任意项： + - **description** — 该智能体的用途 + - **model** — 它的默认模型 + - **temperature** — 它的回答有多有创造性 + - **prompt** — 它始终遵循的固定指令 + - **tool rules** — 它可以使用哪些工具 + +## 你的登录信息存储在哪里 + +提供商登录信息由 OpenCode 存储，而非 OpenChamber，因此它们与 OpenCode CLI 共享。如果你在多个地方设置了同一个提供商，最具体的设置会生效：按项目的设置会覆盖你的个人设置。 + +## 相关内容 + +- [MCP Servers](/zh-cn/mcp/) — 为智能体添加额外工具 +- [用量与配额](/zh-cn/usage/) — 跟踪你已使用的量 diff --git a/packages/docs/content/docs/zh-cn/remote-instances.mdx b/packages/docs/content/docs/zh-cn/remote-instances.mdx new file mode 100644 index 00000000..df58a177 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/remote-instances.mdx @@ -0,0 +1,30 @@ +--- +title: 远程实例 +description: 通过 SSH 将桌面应用连接到另一台机器上的 OpenChamber。 +--- + +# 远程实例 + +桌面应用可以通过 SSH 连接到运行在另一台机器上的 OpenChamber — 工作服务器、云主机、家庭实验室 — 并把它的 UI 带到你的屏幕上，仿佛它在本地一样。在 **Settings → Remote Instances** 中设置它。 + +> 远程实例是一项**仅限桌面**的功能。在网页端或 VS Code 中，请改用 [OpenCode Server](/zh-cn/opencode-server/) 中的环境变量连接到远程服务器。 + +## 添加远程实例 + +1. 打开 **Settings → Remote Instances** 并添加一个。 +2. 给它你通常用来访问该机器的 SSH 命令，外加一个昵称。 +3. 选择 OpenChamber 在那里如何运行： + - **managed** — OpenChamber 在远程机器上安装并启动它自己 + - **external** — 连接到一个已经运行的实例 +4. 连接。 + +OpenChamber 会引导你完成各个步骤 — 检查连接、设置远程、启动服务器并转发端口 — 并在每个阶段显示进度。当它到达 **ready** 时，远程 UI 会在本地加载。 + +## 凭证 + +你来决定是保存 SSH 和 UI 密码，还是每次都输入它们。如果连接断开，OpenChamber 会报告哪一步失败了，以便你修复它 — 参阅 [远程访问](/zh-cn/troubleshooting/remote-access/)。 + +## 相关内容 + +- [OpenCode Server](/zh-cn/opencode-server/) — 在网页端或 VS Code 中连接到远程服务器 +- [远程访问](/zh-cn/troubleshooting/remote-access/) — 当连接无法完成时 diff --git a/packages/docs/content/docs/zh-cn/scheduled-tasks.mdx b/packages/docs/content/docs/zh-cn/scheduled-tasks.mdx new file mode 100644 index 00000000..1d642501 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/scheduled-tasks.mdx @@ -0,0 +1,33 @@ +--- +title: 计划任务 +description: 按计划自动运行提示词。 +--- + +# 计划任务 + +计划任务会按计划为你运行提示词 — 例如每日的“总结昨天的变更”或每周的清理。任务运行时，OpenChamber 会开启一个新会话并自行发送提示词。从会话侧边栏顶部的按钮打开调度器。 + +## 创建任务 + +1. 从会话侧边栏打开计划任务对话框。 +2. 添加一个任务并给它一个名称。 +3. 选择它何时运行： + - **daily** — 每天在一个或多个时间点 + - **weekly** — 在选定的工作日和时间点 + - **once** — 单个日期和时间 +4. 设置它要做什么：要发送的提示词，以及要使用的提供商、模型和智能体。提示词可以是斜杠命令，比如 `/review`。 +5. 保存，并确保该任务已启用。 + +你可以用 **run now** 立即运行任何任务，以检查它是否按预期工作。 + +## 成功的样子 + +运行之后，任务会显示它上次运行的时间、是否成功，以及指向它所创建会话的链接。如果某次运行失败，错误也会显示在那里。 + +## 请记住 + +任务只在 OpenChamber 服务器运行时触发。如果你关闭它，计划任务的运行会被暂停，直到服务器重新启动。 + +## 相关内容 + +- [命令与代码片段](/zh-cn/commands-snippets/) — 复用斜杠命令作为提示词 diff --git a/packages/docs/content/docs/zh-cn/security.mdx b/packages/docs/content/docs/zh-cn/security.mdx new file mode 100644 index 00000000..587596a2 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/security.mdx @@ -0,0 +1,37 @@ +--- +title: 安全 +description: 在公开 UI 之前，用密码和 passkey 保护它。 +--- + +# 安全 + +OpenChamber 让外界可以访问你的机器和代码，所以在除你之外的任何人能够访问它之前，请把它锁好。本页介绍 UI 密码、passkey，以及在将 OpenChamber 暴露到网络之前需要了解的内容。 + +## 设置 UI 密码 + +带密码启动 OpenChamber，浏览器 UI 就会要求输入它： + +```bash +openchamber --ui-password be-creative-here +``` + +你也可以用 `OPENCHAMBER_UI_PASSWORD` 环境变量来设置它，而不是把它放在命令行上。登录后，OpenChamber 会记住该设备一段时间，这样你就不必每次都输入。 + +如果实例可以被其他任何人访问，请务必设置密码 — 尤其是通过 [隧道](/zh-cn/tunnels/) 或公共互联网时。 + +## Passkey + +设置密码后，你可以添加 passkey（Face ID、Touch ID、安全密钥）以便更快登录。在 **Settings → OpenChamber → Passkeys** 中添加它们。 + +passkey 与当前密码绑定。如果你更改或移除密码，已保存的 passkey 会被清除，你需要重新添加它们。 + +## 在暴露它之前 + +- 默认情况下 OpenChamber 只监听你自己的机器（`127.0.0.1`）。需要一次刻意的更改才能更广泛地监听，并且你应该先设置密码。 +- 相比向互联网开放一个端口，更推荐使用 [隧道](/zh-cn/tunnels/) 或专用网络（比如 VPN）。 +- 如果你把 OpenChamber 放在你自己的 HTTPS 服务器后面，请参阅 [反向代理](/zh-cn/reverse-proxy/)。 + +## 相关内容 + +- [隧道](/zh-cn/tunnels/) — 远程访问实例的推荐方式 +- [反向代理](/zh-cn/reverse-proxy/) — 在你自己的服务器后面运行 OpenChamber diff --git a/packages/docs/content/docs/zh-cn/skills-catalog.mdx b/packages/docs/content/docs/zh-cn/skills-catalog.mdx new file mode 100644 index 00000000..f17f2a05 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/skills-catalog.mdx @@ -0,0 +1,27 @@ +--- +title: Skills 目录 +description: 浏览并安装现成的 skill。 +--- + +# Skills 目录 + +Skills 目录让你能够安装其他人发布的 skill，而不必自己编写。在 **Settings → Skills → Catalog** 中打开它。 + +要编写你自己的 skill，请参阅 [Skills](/zh-cn/skills/)。 + +## 安装 skill + +1. 打开目录。 +2. 浏览内置来源 — Anthropic skills 仓库和 ClawdHub 社区注册表 — 或进行搜索。 +3. 选择一个 skill 并安装它。 +4. 选择安装位置：用于你的所有工作，或仅用于当前项目。 + +如果已存在同名的 skill，OpenChamber 会询问该如何处理 — 跳过、覆盖，或逐个 skill 决定。 + +## 添加你自己的来源 + +你可以使用 `owner/repo` 名称或完整的 Git URL，将任何 Git 仓库添加为来源。私有仓库需要在你的机器上设置访问权限（一个 SSH 密钥或已保存的凭证）；如果某个来源无法通过鉴权，目录会明确告知，而不是悄无声息地失败。 + +## 相关内容 + +- [Skills](/zh-cn/skills/) — 创建和管理已安装的 skill diff --git a/packages/docs/content/docs/zh-cn/skills.mdx b/packages/docs/content/docs/zh-cn/skills.mdx new file mode 100644 index 00000000..ae5d7c26 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/skills.mdx @@ -0,0 +1,30 @@ +--- +title: Skills +description: 创建可复用的指令，让智能体按需加载。 +--- + +# Skills + +Skill 是一组可复用的指令，智能体可以在相关时引入它 — 例如“我们如何编写提交信息”或“我们的 API 规范”。你在 **Settings → Skills** 中管理它们。 + +如果想安装现成的 skill 而不是自己编写，请参阅 [Skills 目录](/zh-cn/skills-catalog/)。 + +## 创建 skill + +1. 打开 **Settings → Skills**。 +2. 创建一个 skill，并给它一个名称和一段简短的描述。智能体正是根据描述来判断该 skill 何时适用，因此请写得具体。 +3. 编写指令。如果该 skill 需要支持文件，可以添加它们。 +4. 选择它所在的位置： + - **personal** — 在每个项目中都可用 + - **project** — 仅在当前项目中可用 + +## 在聊天中使用 skill + +在消息中间输入 `/` 可调出 skill 选择器，然后选择一个。智能体会为该次回复加载该 skill 的指令。 + +位于消息最开头的 `/` 会改为打开 [命令](/zh-cn/commands-snippets/)。 + +## 相关内容 + +- [Skills 目录](/zh-cn/skills-catalog/) — 安装他人发布的 skill +- [命令与代码片段](/zh-cn/commands-snippets/) — 在聊天中复用文本的其他方式 diff --git a/packages/docs/content/docs/zh-cn/troubleshooting/opencode-connection.mdx b/packages/docs/content/docs/zh-cn/troubleshooting/opencode-connection.mdx new file mode 100644 index 00000000..daf0328f --- /dev/null +++ b/packages/docs/content/docs/zh-cn/troubleshooting/opencode-connection.mdx @@ -0,0 +1,34 @@ +--- +title: OpenCode 连接 +description: 修复 OpenChamber 无法连接到它的 OpenCode 服务器的问题。 +--- + +# OpenCode 连接 + +如果 OpenChamber 加载了但始终无法越过 “OpenCode is restarting”，或者聊天没有响应，那就是它所通信的服务器无法访问。请逐项排查。 + +## 卡在 “OpenCode is restarting” + +- 启动后稍等片刻 — 服务器启动期间出现此状态是正常的 +- 用 `openchamber status` 检查服务器是否存活 +- 用 `openchamber restart` 重启它 +- 用 `openchamber logs` 查看启动详情 + +## 你正在连接自己的服务器 + +如果你设置了 OpenChamber 使用现有的服务器，请对照 [OpenCode Server](/zh-cn/opencode-server/) 仔细检查配置： + +- `OPENCODE_HOST` 必须包含端口，且不带路径 — 例如 `http://localhost:4096` +- 设置 `OPENCODE_SKIP_START=true`，这样 OpenChamber 就不会同时启动自己的服务器 +- 如果地址无效，OpenChamber 会忽略它并改为启动自己的服务器 — 请在日志中查找 `[config]` 警告 + +## 仍然失败 + +- 确认 Node.js 是 `20` 或更新版本 +- 重新安装最新的 CLI +- 在测试任何隧道或远程链接之前，先直接打开 `http://localhost:3000` + +## 相关内容 + +- [OpenCode Server](/zh-cn/opencode-server/) — OpenChamber 如何查找和管理服务器 +- [问题排查](/zh-cn/troubleshooting/) — 其他常见问题 diff --git a/packages/docs/content/docs/zh-cn/troubleshooting/remote-access.mdx b/packages/docs/content/docs/zh-cn/troubleshooting/remote-access.mdx new file mode 100644 index 00000000..2618ef4b --- /dev/null +++ b/packages/docs/content/docs/zh-cn/troubleshooting/remote-access.mdx @@ -0,0 +1,38 @@ +--- +title: 远程访问 +description: 修复隧道、远程实例，以及从另一台设备访问 OpenChamber 的问题。 +--- + +# 远程访问 + +当你无法从手机或另一台机器访问 OpenChamber 时，修复方法取决于你的连接方式。 + +## 先检查基础项 + +- 先在同一台电脑上打开 `http://localhost:3000` — 如果这都失败，那就不是远程问题；参阅 [OpenCode 连接](/zh-cn/troubleshooting/opencode-connection/) +- 用 `openchamber status` 确认服务器正在运行 + +## 隧道链接无法使用 + +- 运行 `openchamber tunnel status --all` +- 从同一个实例和端口重启隧道 +- 如果之前的连接链接已被使用过，重新生成它 + +完整设置请参阅 [隧道](/zh-cn/tunnels/)。 + +## 远程实例无法连接（桌面端） + +当某个 [远程实例](/zh-cn/remote-instances/) 停滞时，OpenChamber 会指出失败的步骤： + +- **auth** — 你的 SSH 或 UI 密码被拒绝；重新输入它 +- **install / start** — OpenChamber 无法在远程机器上设置或启动服务器；检查该机器的要求 +- **forwarding** — 连接已建立但端口没有到达你；尝试一个不同的本地端口 + +## 在你自己的服务器后面 + +如果你把 OpenChamber 放在反向代理后面，而它加载异常或无法连接，请参阅 [反向代理](/zh-cn/reverse-proxy/)。 + +## 相关内容 + +- [隧道](/zh-cn/tunnels/) · [远程实例](/zh-cn/remote-instances/) · [反向代理](/zh-cn/reverse-proxy/) +- [安全](/zh-cn/security/) — 在公开 UI 之前保护它 diff --git a/packages/docs/content/docs/zh-cn/troubleshooting/worktrees-git.mdx b/packages/docs/content/docs/zh-cn/troubleshooting/worktrees-git.mdx new file mode 100644 index 00000000..69ecd0a5 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/troubleshooting/worktrees-git.mdx @@ -0,0 +1,35 @@ +--- +title: Worktree 与 Git +description: 修复常见的 worktree 和 git 问题。 +--- + +# Worktree 与 Git + +[worktree 会话](/zh-cn/worktrees/) 和 [git 视图](/zh-cn/git/) 中可能出现的问题，以及如何清除它们。 + +## worktree 需要关注 + +OpenChamber 会在出现异常时标记某个 worktree： + +- **folder missing** — worktree 的文件夹在 OpenChamber 之外被删除或移动了；移除该会话并创建一个新的 worktree +- **detached or unborn branch** — worktree 不在正常的分支上；将它检出到一个分支上 +- **merge, rebase, or cherry-pick in progress** — 某个操作处于半完成状态；在 git 视图中完成或中止它 + +## 无法创建 worktree + +- **branch already exists** — 选择一个不同的分支名，或使用现有分支选项 +- **name already in use** — 选择一个不同的 worktree 名称 + +## 提交信息或 PR 生成失败 + +生成提交信息或 PR 描述会在你的活动会话中运行，因此你需要打开一个会话，并选中一个可用的模型。打开或选择一个会话，然后重试。 + +## SSH 或 Windows 路径问题 + +- 确保仓库所使用的 SSH 密钥就是你在 [git 身份](/zh-cn/git-identities/) 中设置的那个 +- 在 Windows 上，git 使用 Unix 风格的路径（比如 `/c/Users/...`）— OpenChamber 会处理这一点，但自定义的 SSH 密钥路径应遵循相同的形式 + +## 相关内容 + +- [Worktree 会话](/zh-cn/worktrees/) — worktree 如何被创建和移除 +- [Git 身份](/zh-cn/git-identities/) — 为每个仓库设置正确的密钥和身份 diff --git a/packages/docs/content/docs/zh-cn/tunnels.mdx b/packages/docs/content/docs/zh-cn/tunnels.mdx index 0e049f21..e057db24 100644 --- a/packages/docs/content/docs/zh-cn/tunnels.mdx +++ b/packages/docs/content/docs/zh-cn/tunnels.mdx @@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000 ## 相关内容 +- [安全](/zh-cn/security/) — 在开放访问前保护 UI +- [PWA 与移动访问](/zh-cn/mobile/) — 从手机访问 OpenChamber - [问题排查](/zh-cn/troubleshooting/) — 如果隧道链接无法使用 diff --git a/packages/docs/content/docs/zh-cn/updates.mdx b/packages/docs/content/docs/zh-cn/updates.mdx new file mode 100644 index 00000000..6f3f02b7 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/updates.mdx @@ -0,0 +1,31 @@ +--- +title: 更新 +description: 在桌面端、网页端和 VS Code 上保持 OpenChamber 最新。 +--- + +# 更新 + +你如何更新 OpenChamber 取决于你如何安装它。在任何情况下，你都可以在 **Settings → OpenChamber → About** 查看你的当前版本。 + +## 桌面应用 + +桌面应用会对照 GitHub 发布版本检查更新。当有可用更新时，OpenChamber 会告诉你，在你选择时下载它，并在下次重启时安装它。一切都由你掌控 — 没有你的同意不会安装任何东西。 + +## 网页端 / CLI + +如果你安装的是 CLI，可以从 **About** 用检查和更新按钮更新它，或从终端更新： + +```bash +openchamber update +``` + +OpenChamber 会检测它是如何安装的（npm、pnpm、yarn 或 bun），并为你运行正确的更新。 + +## OpenCode 服务器 + +OpenChamber 和 OpenCode 分别更新。当有新的 OpenCode 版本可用时，OpenChamber 会提议更新它，并在之后重启服务器。关于该服务器如何被管理，请参阅 [OpenCode Server](/zh-cn/opencode-server/)。 + +## 相关内容 + +- [安装](/zh-cn/install/) — 每个应用最初是如何安装的 +- [OpenCode Server](/zh-cn/opencode-server/) — 更新底层服务器 diff --git a/packages/docs/content/docs/zh-cn/usage.mdx b/packages/docs/content/docs/zh-cn/usage.mdx new file mode 100644 index 00000000..c2c9b9da --- /dev/null +++ b/packages/docs/content/docs/zh-cn/usage.mdx @@ -0,0 +1,28 @@ +--- +title: 用量与配额 +description: 跟踪你已使用的提供商套餐额度。 +--- + +# 用量与配额 + +用量页面显示你已使用的每个提供商套餐的额度，让你能看到自己距离限额还有多远。在 **Settings → Usage** 中打开它。 + +## 你能看到什么 + +对于每个已连接的提供商，OpenChamber 会显示： + +- 当前周期内你已使用的量，以进度条形式展示 +- 按模型的细分 +- 一个速率指示器，让你判断自己是否会用尽额度 + +你可以选择哪些提供商出现在此处，相同的摘要也可以从应用标题栏的下拉菜单中查看。 + +## 支持的提供商 + +用量功能适用于那些公布配额的提供商，包括 Claude、Codex、GitHub Copilot、Google、OpenRouter、Kimi、NanoGPT、z.ai、Zhipu、MiniMax、Ollama Cloud 和 Wafer。 + +只有在你于 [提供商](/zh-cn/providers/) 页面登录某个提供商后，它才会显示用量。少数提供商需要额外的步骤 — 例如，Ollama Cloud 会读取一个你单独设置的会话文件。如果某个提供商没有显示数据，通常意味着缺少这个额外的凭证。 + +## 相关内容 + +- [提供商、模型与智能体](/zh-cn/providers/) — 登录后用量才会出现 diff --git a/packages/docs/content/docs/zh-cn/voice.mdx b/packages/docs/content/docs/zh-cn/voice.mdx new file mode 100644 index 00000000..06399d53 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/voice.mdx @@ -0,0 +1,36 @@ +--- +title: 语音模式 +description: 对 OpenChamber 说话，并听它朗读回复。 +--- + +# 语音模式 + +语音模式让你可以口述消息，并让回复朗读给你听。在 **Settings → OpenChamber → Voice** 中开启它。 + +## 朗读回复（文本转语音） + +选择回复如何被朗读： + +- **browser** — 你浏览器的内置语音，无需设置 +- **OpenAI** — OpenAI 的语音；粘贴你的 API 密钥并选择一种语音 +- **OpenAI-compatible** — 任何使用 OpenAI 格式的服务；输入它的 URL，以及（如有需要）一个 API 密钥 +- **macOS say** — 内置的 `say` 命令，在拥有它的 Mac 上 + +开启后，你会在消息上看到一个播放按钮，可以听它们被朗读出来。 + +## 口述消息（语音转文本） + +选择你的语音如何被转写： + +- **browser** — 你浏览器的内置识别，无需设置 +- **server** — 一个 OpenAI 兼容的转写服务；输入它的 URL，以及（如有需要）一个 API 密钥 +- **on-device** — 一个在你浏览器中运行的语音模型，首次使用时会下载 + +## 给手机的提示 + +要在手机上朗读回复，OpenAI 或 OpenAI-compatible 选项最可靠 — 移动浏览器会限制内置语音。 + +## 相关内容 + +- [通知](/zh-cn/notifications/) — 改为收到提醒而不是聆听 +- [提供商、模型与智能体](/zh-cn/providers/) — 你的 OpenAI 密钥可能已经存放在这里 diff --git a/packages/docs/content/docs/zh-cn/worktrees.mdx b/packages/docs/content/docs/zh-cn/worktrees.mdx new file mode 100644 index 00000000..c52076a9 --- /dev/null +++ b/packages/docs/content/docs/zh-cn/worktrees.mdx @@ -0,0 +1,36 @@ +--- +title: Worktree 会话 +description: 为会话提供独立的分支和文件夹，让工作保持隔离。 +--- + +# Worktree 会话 + +worktree 会话运行在你仓库自己独立检出的副本中，位于它自己的分支上（一个 git worktree）。这能防止并行会话相互干扰彼此的文件 — 一个会话可以做重构，另一个可以修复 bug，无需来回切换。 + +## 创建一个 + +1. 从会话侧边栏顶部的按钮打开新建 worktree 对话框。 +2. 选择一个起点： + - **new branch** — 命名分支并选择从哪个分支开始 + - **existing branch** — 检出一个你已经拥有的分支 +3. 确认 worktree 文件夹（OpenChamber 会根据分支名建议一个）。 +4. 创建它。 + +OpenChamber 会创建分支、设置文件夹，并在其中启动一个会话。你也可以直接从一个 [待办](/zh-cn/notes-todos-plans/) 或一个 [GitHub issue 或 PR](/zh-cn/github/) 发起一个。 + +## 把工作带回来 + +当工作完成得不错时，在 Git 视图中使用 **Integrate** 将 worktree 的提交带到另一个分支（比如 `main`）上。如果某个变更产生冲突，你可以把冲突交给智能体来解决。 + +## 清理 + +删除或归档会话可以移除 worktree。你可以选择是否同时删除分支 — 本地的，以及远程的（如果有）。没有你的请求，不会删除任何东西。 + +## 如果有什么看起来不对劲 + +如果 worktree 的文件夹丢失、分支处于游离状态，或一次合并或变基处于半完成状态，它可能需要关注。OpenChamber 会标记这些情况，以便你修复它们 — 参阅 [Worktree 与 Git](/zh-cn/troubleshooting/worktrees-git/)。 + +## 相关内容 + +- [Multi-run](/zh-cn/multi-run/) — 一次启动多个 worktree 会话 +- [Git 与 GitHub 工作流](/zh-cn/git/) — 在 OpenChamber 内部提交和集成 diff --git a/packages/docs/sidebar.config.json b/packages/docs/sidebar.config.json index 7ed393f7..76b29bfa 100644 --- a/packages/docs/sidebar.config.json +++ b/packages/docs/sidebar.config.json @@ -47,6 +47,257 @@ "pl": "Szybki start" } }, + { + "label": "OpenCode Server", + "link": "/opencode-server/", + "translations": { + "uk": "Сервер OpenCode", + "zh-CN": "OpenCode 服务器", + "es": "Servidor OpenCode", + "pt-BR": "Servidor OpenCode", + "ko": "OpenCode 서버", + "pl": "Serwer OpenCode" + } + } + ] + }, + { + "label": "Workflows", + "translations": { + "uk": "Робочі процеси", + "zh-CN": "工作流", + "es": "Flujos de trabajo", + "pt-BR": "Fluxos de trabalho", + "ko": "워크플로", + "pl": "Przepływy pracy" + }, + "items": [ + { + "label": "Projects", + "link": "/projects/", + "translations": { + "uk": "Проєкти", + "zh-CN": "项目", + "es": "Proyectos", + "pt-BR": "Projetos", + "ko": "프로젝트", + "pl": "Projekty" + } + }, + { + "label": "Context", + "link": "/context/", + "translations": { + "uk": "Контекст", + "zh-CN": "上下文", + "es": "Contexto", + "pt-BR": "Contexto", + "ko": "컨텍스트", + "pl": "Kontekst" + } + }, + { + "label": "Notes, Todos & Plans", + "link": "/notes-todos-plans/", + "translations": { + "uk": "Нотатки, справи та плани", + "zh-CN": "笔记、待办与计划", + "es": "Notas, tareas y planes", + "pt-BR": "Notas, tarefas e planos", + "ko": "메모, 할 일, 계획", + "pl": "Notatki, zadania i plany" + } + }, + { + "label": "Scheduled Tasks", + "link": "/scheduled-tasks/", + "translations": { + "uk": "Заплановані задачі", + "zh-CN": "计划任务", + "es": "Tareas programadas", + "pt-BR": "Tarefas agendadas", + "ko": "예약 작업", + "pl": "Zaplanowane zadania" + } + }, + { + "label": "Project Actions", + "link": "/project-actions/", + "translations": { + "uk": "Дії проєкту", + "zh-CN": "项目操作", + "es": "Acciones del proyecto", + "pt-BR": "Ações do projeto", + "ko": "프로젝트 작업", + "pl": "Akcje projektu" + } + }, + { + "label": "Preview & Dev Servers", + "link": "/preview/", + "translations": { + "uk": "Перегляд і dev-сервери", + "zh-CN": "预览与开发服务器", + "es": "Vista previa y servidores de desarrollo", + "pt-BR": "Pré-visualização e servidores de desenvolvimento", + "ko": "미리보기 및 개발 서버", + "pl": "Podgląd i serwery deweloperskie" + } + }, + { + "label": "Worktree Sessions", + "link": "/worktrees/", + "translations": { + "uk": "Сесії worktree", + "zh-CN": "Worktree 会话", + "es": "Sesiones de worktree", + "pt-BR": "Sessões de worktree", + "ko": "Worktree 세션", + "pl": "Sesje worktree" + } + }, + { + "label": "Multi-run", + "link": "/multi-run/" + }, + { + "label": "Git & GitHub", + "link": "/git/" + }, + { + "label": "GitHub Issues & PRs", + "link": "/github/", + "translations": { + "uk": "Завдання та PR GitHub", + "zh-CN": "GitHub 工单与 PR", + "es": "Issues y PRs de GitHub", + "pt-BR": "Issues e PRs do GitHub", + "ko": "GitHub 이슈 및 PR", + "pl": "Zgłoszenia i PR-y GitHub" + } + }, + { + "label": "Magic Prompts", + "link": "/magic-prompts/", + "translations": { + "uk": "Магічні підказки", + "zh-CN": "魔法提示词", + "es": "Prompts mágicos", + "pt-BR": "Prompts mágicos", + "ko": "매직 프롬프트", + "pl": "Magiczne prompty" + } + }, + { + "label": "Git Identities", + "link": "/git-identities/", + "translations": { + "uk": "Git-ідентичності", + "zh-CN": "Git 身份", + "es": "Identidades de Git", + "pt-BR": "Identidades do Git", + "ko": "Git 아이덴티티", + "pl": "Tożsamości Git" + } + } + ] + }, + { + "label": "OpenCode setup", + "translations": { + "uk": "Налаштування OpenCode", + "zh-CN": "OpenCode 设置", + "es": "Configuración de OpenCode", + "pt-BR": "Configuração do OpenCode", + "ko": "OpenCode 설정", + "pl": "Konfiguracja OpenCode" + }, + "items": [ + { + "label": "Providers, Models & Agents", + "link": "/providers/", + "translations": { + "uk": "Провайдери, моделі та агенти", + "zh-CN": "提供商、模型与智能体", + "es": "Proveedores, modelos y agentes", + "pt-BR": "Provedores, modelos e agentes", + "ko": "공급자, 모델, 에이전트", + "pl": "Dostawcy, modele i agenci" + } + }, + { + "label": "MCP Servers", + "link": "/mcp/", + "translations": { + "uk": "Сервери MCP", + "zh-CN": "MCP 服务器", + "es": "Servidores MCP", + "pt-BR": "Servidores MCP", + "ko": "MCP 서버", + "pl": "Serwery MCP" + } + }, + { + "label": "Skills", + "link": "/skills/", + "translations": { + "uk": "Навички", + "zh-CN": "技能", + "es": "Habilidades", + "pt-BR": "Habilidades", + "ko": "스킬", + "pl": "Umiejętności" + } + }, + { + "label": "Skills Catalog", + "link": "/skills-catalog/", + "translations": { + "uk": "Каталог навичок", + "zh-CN": "技能目录", + "es": "Catálogo de habilidades", + "pt-BR": "Catálogo de habilidades", + "ko": "스킬 카탈로그", + "pl": "Katalog umiejętności" + } + }, + { + "label": "Commands & Snippets", + "link": "/commands-snippets/", + "translations": { + "uk": "Команди та сніпети", + "zh-CN": "命令与代码片段", + "es": "Comandos y fragmentos", + "pt-BR": "Comandos e trechos", + "ko": "명령 및 스니펫", + "pl": "Polecenia i fragmenty" + } + }, + { + "label": "Usage & Quotas", + "link": "/usage/", + "translations": { + "uk": "Використання та квоти", + "zh-CN": "用量与配额", + "es": "Uso y cuotas", + "pt-BR": "Uso e cotas", + "ko": "사용량 및 할당량", + "pl": "Zużycie i limity" + } + } + ] + }, + { + "label": "Remote access", + "translations": { + "uk": "Віддалений доступ", + "zh-CN": "远程访问", + "es": "Acceso remoto", + "pt-BR": "Acesso remoto", + "ko": "원격 접속", + "pl": "Dostęp zdalny" + }, + "items": [ { "label": "Tunnels", "link": "/tunnels/", @@ -58,6 +309,42 @@ "ko": "터널", "pl": "Tunele" } + }, + { + "label": "Reverse Proxy", + "link": "/reverse-proxy/", + "translations": { + "uk": "Зворотний проксі", + "zh-CN": "反向代理", + "es": "Proxy inverso", + "pt-BR": "Proxy reverso", + "ko": "리버스 프록시", + "pl": "Reverse proxy" + } + }, + { + "label": "PWA & Mobile", + "link": "/mobile/", + "translations": { + "uk": "PWA та мобільний доступ", + "zh-CN": "PWA 与移动端", + "es": "PWA y móvil", + "pt-BR": "PWA e celular", + "ko": "PWA 및 모바일", + "pl": "PWA i urządzenia mobilne" + } + }, + { + "label": "Security", + "link": "/security/", + "translations": { + "uk": "Безпека", + "zh-CN": "安全", + "es": "Seguridad", + "pt-BR": "Segurança", + "ko": "보안", + "pl": "Bezpieczeństwo" + } } ] }, @@ -83,6 +370,91 @@ "ko": "테마", "pl": "Motywy" } + }, + { + "label": "Notifications", + "link": "/notifications/", + "translations": { + "uk": "Сповіщення", + "zh-CN": "通知", + "es": "Notificaciones", + "pt-BR": "Notificações", + "ko": "알림", + "pl": "Powiadomienia" + } + }, + { + "label": "Voice Mode", + "link": "/voice/", + "translations": { + "uk": "Голосовий режим", + "zh-CN": "语音模式", + "es": "Modo de voz", + "pt-BR": "Modo de voz", + "ko": "음성 모드", + "pl": "Tryb głosowy" + } + }, + { + "label": "Project Icons", + "link": "/project-icons/", + "translations": { + "uk": "Іконки проєктів", + "zh-CN": "项目图标", + "es": "Iconos de proyecto", + "pt-BR": "Ícones de projeto", + "ko": "프로젝트 아이콘", + "pl": "Ikony projektów" + } + } + ] + }, + { + "label": "Desktop", + "translations": { + "uk": "Десктоп", + "zh-CN": "桌面端", + "es": "Escritorio", + "pt-BR": "Desktop", + "ko": "데스크톱", + "pl": "Pulpit" + }, + "items": [ + { + "label": "Remote Instances", + "link": "/remote-instances/", + "translations": { + "uk": "Віддалені інстанси", + "zh-CN": "远程实例", + "es": "Instancias remotas", + "pt-BR": "Instâncias remotas", + "ko": "원격 인스턴스", + "pl": "Zdalne instancje" + } + }, + { + "label": "Desktop Browser", + "link": "/desktop-browser/", + "translations": { + "uk": "Десктопний браузер", + "zh-CN": "桌面浏览器", + "es": "Navegador de escritorio", + "pt-BR": "Navegador desktop", + "ko": "데스크톱 브라우저", + "pl": "Przeglądarka na pulpicie" + } + }, + { + "label": "Updates", + "link": "/updates/", + "translations": { + "uk": "Оновлення", + "zh-CN": "更新", + "es": "Actualizaciones", + "pt-BR": "Atualizações", + "ko": "업데이트", + "pl": "Aktualizacje" + } } ] }, @@ -97,18 +469,6 @@ "pl": "Pomoc" }, "items": [ - { - "label": "Reverse Proxy", - "link": "/reverse-proxy/", - "translations": { - "uk": "Зворотний проксі", - "zh-CN": "反向代理", - "es": "Proxy inverso", - "pt-BR": "Proxy reverso", - "ko": "리버스 프록시", - "pl": "Reverse proxy" - } - }, { "label": "Troubleshooting", "link": "/troubleshooting/", @@ -120,6 +480,42 @@ "ko": "문제 해결", "pl": "Rozwiązywanie problemów" } + }, + { + "label": "OpenCode Connection", + "link": "/troubleshooting/opencode-connection/", + "translations": { + "uk": "Підключення до OpenCode", + "zh-CN": "OpenCode 连接", + "es": "Conexión con OpenCode", + "pt-BR": "Conexão com o OpenCode", + "ko": "OpenCode 연결", + "pl": "Połączenie z OpenCode" + } + }, + { + "label": "Worktrees & Git", + "link": "/troubleshooting/worktrees-git/", + "translations": { + "uk": "Worktree та Git", + "zh-CN": "Worktree 与 Git", + "es": "Worktrees y Git", + "pt-BR": "Worktrees e Git", + "ko": "Worktree 및 Git", + "pl": "Worktree i Git" + } + }, + { + "label": "Remote Access", + "link": "/troubleshooting/remote-access/", + "translations": { + "uk": "Віддалений доступ", + "zh-CN": "远程访问", + "es": "Acceso remoto", + "pt-BR": "Acesso remoto", + "ko": "원격 접속", + "pl": "Dostęp zdalny" + } } ] }