Features

Belloga harness

Belloga feeds a per-branch work plan and your rules to Claude Code sessions started in a Belloga terminal.

• Only inside Belloga: Sessions started in other terminals or apps are left alone.
• Never forced: Belloga does not edit the harness in ~/.claude. When instructions conflict, the session follows your harness or asks you. A missing or malformed work plan is flagged, not blocked.
• The app sets the shape, you set the content: Belloga decides the locations and the skeleton it reads. You decide what goes in through templates.

The harness has four parts.

• Work plan: Each branch gets requirements.md, design.md and tasks.md in ~/.belloga/plans/{owner}/{repo}/{branch}. Nothing is written inside the repository.
• Templates: requirements.md has a template per task type (new feature, bug fix, refactor, behavior change). design.md and tasks.md have one each. When you create a worktree, requirements.md is pre-filled from the template of the type you picked.
• Rules: Rules in ~/.belloga/agents/rules are injected when a session starts and when the context is compacted or cleared with /clear.
• Harness mode: Edit templates and rules from the sidebar. Hooks are turned on and off separately in the Belloga hooks tab of the settings.

Main features

• Connect folders, discover repositories: Connect a folder and Belloga groups the repositories and worktrees inside it by their git relationships. Files outside the repositories open and edit in the same tree. Several repositories can be handled as one project.
• Agent terminals: A terminal per worktree. The sidebar and tab titles show whether each Claude Code session is working, waiting for permission, or idle. Notifications and usage display are included.
• Work plan progress: Next to each worktree you see the task type, task progress and format problems. Click to open the work plan.
• View and edit files: Opens code, Markdown and PDF. Markdown switches between rendered and source views.
• Notes: See Markdown links as a graph, and draw Excalidraw pictures and embed them with ![[drawing]]. Drawings use the same .excalidraw.md format as Obsidian.
• Review and commit: Read diffs, stage by file or hunk, and commit, push and pull inside the app.
• Worktree management: Pick a task type to create a worktree. Before deleting one, Belloga counts the changes you would lose.
• Hand off to VS Code: When you need a full editor, open the file or worktree folder in VS Code.

The sidebar switches between five modes on the left rail: worktrees, files, git, graph and harness. The work area splits into tabs so several views sit side by side.

What Belloga does not build

• Interactive rebase, cherry-pick, conflict resolution, branch graphs and stash management. Use a terminal or an existing git client for those.
• Debuggers, language servers and extensions. The app covers reading and light edits, and leaves the rest to VS Code.
• git authentication. Push and pull use the git credentials and SSH keys already set up on your machine.