ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Vibe Kanban 如何从 npx vibe-kanban 启动并完成首次配置、登录与第一个工作区

Vibe Kanban 如何从 npx vibe-kanban 启动并完成首次配置、登录与第一个工作区 Vibe Kanban 如何从 npx vibe-kanban 启动并完成首次配置、登录与第一个工作区【免费下载链接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent项目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban你的任务是第一次在本机运行 Vibe Kanban通过npx vibe-kanban在浏览器中打开它完成首次偏好设置登录账号然后创建并启动第一个 workspace工作区让 coding agent 在隔离的 git worktree 中开始执行任务。整个过程不需要本地编译或安装服务一条命令即可启动。启动前的准备条件根据 npx-cli/README.md 的 Requirements 与 Supported Platforms 说明Node.jsnpx执行所必需Git仓库操作所必需代码编辑器可选仅用于打开任务 worktree已认证好的 coding agentREADME 明确要求Make sure you have authenticated with your favourite coding agent支持的 agent 列表见 docs/supported-coding-agents.mdxClaude Code、OpenAI Codex、GitHub Copilot、Gemini CLI、Amp、Cursor Agent CLI、OpenCode、Droid、Claude Code Router、Qwen Code 等每个 agent 需要先完成各自的安装与认证平台Linux x64、Windows x64、macOS x64Intel、macOS ARM64Apple Silicon。第一步用 npx 启动 Vibe Kanban在终端中运行npx vibe-kanban这会本地启动应用并自动在浏览器中打开 UI见 npx-cli/README.md Quick Start。启动后可以先用以下入口命令核对安装是否正常npx vibe-kanban --help npx vibe-kanban --version如果启动过程出现难以判断的错误可以开调试日志docs/troubleshooting.mdxRUST_LOGdebug npx vibe-kanban第二步完成首次偏好设置第一次运行时Vibe Kanban 会要求你设置三项偏好docs/getting-started.mdxCoding agent编码 agentIDE代码编辑器Notification preferences通知偏好这些偏好之后随时可以在 settings dialog 中修改。相关的全局设置项默认 coding agent、编辑器、Git 分支前缀、Workspace Directory、通知等在Settings → General中说明见 docs/settings/general.mdx。如果后续需要为某个 agent 配置 model、plan mode、权限级别等变体入口是Settings → Agents见 docs/settings/agent-configurations.mdx。第三步登录Sign inVibe Kanban Cloud 使用 OAuth可以直接用现有的GitHub或Google账号登录不需要另建密码docs/cloud/authentication.mdx点击Sign in with GitHub或Sign in with Google在 GitHub 上点AuthorizeGoogle 上点Allow授权授权后自动跳回 Vibe Kanban 完成登录。权限范围最小化GitHub 只提供公开 profile名称、邮箱、头像不会访问私有仓库也看不到你的密码。如果暂时不想登录可以点More options→I understand, continue without signing in跳过。注意后果仍然可以创建 workspaces但kanban board、issues 和 team 功能不可用——而本文的目标路径包含创建 issue 与 workspace所以建议正常登录。登录后系统会自动为你创建一个personal organisation和一个initial project并直接带你进入docs/getting-started.mdx 第 4 步这一步可以作为登录成功的验证。第四步准备 issuekanban 卡片Issues 是 Vibe Kanban 的核心概念代表一个 bug、feature 或待办工作最少包含 title 和 description还可以加 priority、tag、父子关系。操作路径在 kanban board 上用new issue按钮创建 issue填写 title 和 description 后点create issue。注意一个细节workspace可以关联到 issue但并非必须——不关联 issue 的 workspace 适合问一下代码库这类快速操作docs/getting-started.mdx 第 6 步 Info。本文按完整路径走先创建 issue 再建 workspace。第五步创建第一个 workspaceWorkspace 是与 coding agent 一起处理 issue 的执行空间。创建时 Vibe Kanban 会自动为选定的仓库创建 git worktree原仓库不受影响、基于 target branch 自动创建工作分支、启动你的 coding agentdocs/getting-started.mdx 第 6 步、docs/workspaces/creating-workspaces.mdx。操作路径确保刚创建的 issue 处于选中状态在 workspaces 面板点create按钮选择仓库与分支Recent repositories——从最近列表直接点选Browse repos on disk——查找不在最近列表中的本地 git 仓库Create new repo on disk——初始化一个全新的 git 仓库。如果还没有项目可以先在Project下拉框里点 Create new project输入名称后点Create新项目会被自动选中docs/workspaces/creating-workspaces.mdx。项目也可以来自从现有 git 仓库导入或创建空白项目见 docs/core-features/creating-projects.mdx。为每个仓库设置target branch如main即变更最终要合入的分支工作分支会自动生成例如vk/abc123-add-login-pagevk前缀可在 Settings → General → Git → Branch Prefix 修改在底部 chat input 中描述任务——写清楚要什么功能/修复、约束条件、代码库中要关注的区域从Agent下拉框选择 coding agent 配置可用 agent 取决于你本机已安装并认证的 agent点Create。创建后agent 会立即带着你给的 prompt 开始执行。worktree 存放在.vibe-kanban-workspaces目录下每个 workspace 一个文件夹该位置可在Settings → General → Workspace Directory配置修改后需要重启应用且已有 workspace 不会迁移。验证结果以下现象对应各环节完成启动成功浏览器自动打开了 Vibe Kanban UI登录成功进入界面后存在自动创建的 personal organisation 与 initial project并直接落在项目页workspace 创建成功workspace 出现在列表中agent 会话启动coding agent 开始执行你的 prompt可在 workspace 的 Logs 面板观察执行过程原仓库中未看到改动因为变更发生在自动生成的工作分支上后续想获得更大的评审空间时点Open Workspace进入 workspaces view可以查看代码改动或在内置浏览器中预览docs/getting-started.mdx 第 7 步。常见问题以下排查项都来自 docs/troubleshooting.mdx 与 docs/workspaces/creating-workspaces.mdx 的 Troubleshooting 章节agent 报告代码库是空的可能是仓库启用了 Git sparse-checkout。在仓库根目录执行git sparse-checkout disable然后重新创建任务。workspace 创建失败常见原因包括原仓库有未提交改动导致 worktree 创建失败、分支名冲突、磁盘空间不足。对应处理commit 或 stash 原仓库的未提交改动、换 target branch、检查磁盘空间worktree 需要存放完整跟踪文件副本的空间。workspace 创建后 agent 不启动检查 agent 是否已安装在终端手动跑一次其 CLI、API key 是否已配置Settings → Agents、网络是否连通。仓库不出现在列表中该文件夹可能不是 git 仓库缺少.git目录、路径不可访问或 Vibe Kanban 没有访问该目录的权限可以点Browse repos on disk手动定位。需要更详细的日志用RUST_LOGdebug npx vibe-kanban重启获得 verbose 日志输出。最后一条是有破坏性的手段谨慎使用如果遇到不可恢复的错误可以删除应用数据目录把数据库清零重置所有任务与设置都会丢失删除前先自行备份——macOS 为~/Library/Application Support/ai.bloop.vibe-kanban/Linux 为~/.local/share/vibe-kanban/Windows 为%APPDATA%\bloop\vibe-kanban\。删除后重启 Vibe Kanban 即以空数据库和默认设置重新开始。完成后的限制与下一步未登录时More options 跳过只能创建 workspacekanban board、issues 与 team 功能不可用修改 Workspace Directory 后必须重启应用才生效项目脚本setup scripts、dev server scripts、cleanup scripts、Copy Files需要在项目设置中单独配置创建项目后点右上角 settings 按钮进入docs/core-features/creating-projects.mdx。workspace 中 agent 跑完之后下一步通常是评审 diffdocs/workspaces/changes.mdx、在本地合并分支或开 GitHub PRdocs/getting-started.mdx 第 8 步。【免费下载链接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent项目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表