vibora 0.1.6 → 0.1.8

package/LICENSE

@@ -0,0 +1,157 @@
+# PolyForm Shield License 1.0.0
+
+<https://polyformproject.org/licenses/shield/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software
+to do everything you might do with the software that would
+otherwise infringe the licensor's copyright in it for any
+permitted purpose. However, you may only distribute the
+software according to [Distribution](#distribution).
+
+## Distribution
+
+The licensor grants you an additional copyright license
+to distribute copies of the software. Your license to
+distribute covers distributing the software with changes
+and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software. For example:
+
+> Required Notice: Copyright KNOWSUCHAGENCY CORP (https://github.com/knowsuchagency/vibora)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncompete
+
+Any purpose is a permitted purpose, except for providing any
+product that competes with the software or any product the
+licensor or any of its affiliates provides using the software.
+
+## Competition
+
+Goods and services compete even when they provide functionality
+through different kinds of interfaces or for different technical
+platforms. Applications can compete with services, libraries
+with plugins, frameworks with development tools, and so on,
+even if they're written in different programming languages
+or for different computer architectures. Goods and services
+compete even when provided free of charge. If you market a
+product as a practical substitute for the software or another
+product, it definitely competes.
+
+## New Products
+
+If you are using the software to provide a product that does
+not compete, but the licensor or any of its affiliates brings
+your product into competition by providing a new version of
+the software or another product using the software, you may
+continue using versions of the software available under these
+terms beforehand to provide your competing product, but not
+any later versions.
+
+## Discontinued Products
+
+You may begin using the software to compete with a product
+or service that the licensor or any of its affiliates has
+stopped providing, unless the licensor includes a plain-text
+line beginning with `Licensor Line of Business:` with the
+software that mentions that line of business. For example:
+
+> Licensor Line of Business: Developer Tools
+
+## Sales of Business
+
+If the licensor or any of its affiliates sells a line of
+business developing the software or using the software to
+provide a product, the buyer can also enforce
+[Noncompete](#noncompete) for that product.
+
+## Compliance
+
+You must exercise your license with a good-faith belief that
+it falls within the scope of [Noncompete](#noncompete). If the
+licensor notifies you in writing that you have not, you must
+remedy all identified problems within 32 days after that notice.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else. These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice. Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the
+**software** is the software the licensor makes available
+under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization. **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise. Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.
+
+---
+
+Required Notice: Copyright KNOWSUCHAGENCY CORP (https://github.com/knowsuchagency/vibora)

package/README.md

@@ -0,0 +1,138 @@
+# Vibora
+
+![vibora](https://raw.githubusercontent.com/knowsuchagency/vibora/main/public/vibora-logo.jpeg)
+
+
+A lightweight PM cockpit for streamlining the software development lifecycle. Vibora marries basic project management with actual software development by embedding terminals directly into the workflow.
+
+## Philosophy
+
+- **Terminal-first AI agent orchestration** — Agents (Claude Code, Codex, etc.) run in terminals as-is. No abstraction layer, no wrapper APIs, no feature parity maintenance as agents evolve.
+- **Opinionated with few opinions** — Provides structure without dictating workflow.
+- **Git worktree isolation** — Tasks create isolated git worktrees, with architecture supporting evolution toward more general task types.
+
+## Tech Stack
+
+- **Frontend**: React 19, TanStack Router & Query, xterm.js, Tailwind CSS, shadcn/ui (v4 with baseui support)
+- **Backend**: Hono.js on Bun, SQLite with Drizzle ORM, WebSocket for terminal I/O
+
+## Getting Started
+
+### Prerequisites
+
+- [mise](https://mise.jdx.dev/) for task running and tool management
+- [Bun](https://bun.sh/) (installed automatically via mise)
+
+### Development
+
+```bash
+# Install tools and dependencies
+mise install
+
+# Start both frontend and backend (recommended)
+mise run dev
+
+# Or run separately:
+mise run server    # Backend (port 3333, with auto-reload)
+mise run client    # Frontend (port 5173, proxies to backend)
+```
+
+### Available Tasks
+
+```bash
+mise run dev          # Start frontend and backend dev servers
+mise run server       # Start backend dev server with auto-reload
+mise run client       # Start frontend dev server
+mise run build        # Build for production
+mise run start        # Run production server
+mise run lint         # Run ESLint
+mise run preview      # Preview production build
+
+# Database operations
+mise run db:push      # Sync schema to database
+mise run db:studio    # Open Drizzle Studio GUI
+mise run db:generate  # Generate migrations
+mise run db:migrate   # Apply migrations
+```
+
+## Configuration
+
+Settings are stored in `.vibora/settings.json`. The vibora directory is resolved in this order:
+1. `VIBORA_DIR` environment variable (explicit override)
+2. `.vibora` in current working directory (per-worktree isolation)
+3. `~/.vibora` (default)
+
+| Setting | Env Var | Default |
+|---------|---------|---------|
+| (base directory) | `VIBORA_DIR` | .vibora in CWD or ~/.vibora |
+| port | `PORT` | 3333 |
+| defaultGitReposDir | `VIBORA_GIT_REPOS_DIR` | ~ |
+| linearApiKey | `LINEAR_API_KEY` | null |
+
+Database path (`{viboraDir}/vibora.db`) and worktree path (`{viboraDir}/worktrees`) are derived from the vibora directory and not separately configurable.
+
+Precedence: environment variable → settings.json → default
+
+## CLI
+
+Vibora includes a CLI for AI agents (like Claude Code) working inside task worktrees to query and update task status.
+
+### Installation
+
+```bash
+cd cli
+bun install
+bun link    # Makes 'vibora' available globally
+```
+
+### Usage
+
+```bash
+# Get current task (auto-detected from worktree path)
+vibora current-task
+
+# Update task status
+vibora current-task in-progress  # Mark as IN_PROGRESS
+vibora current-task review       # Mark as IN_REVIEW
+vibora current-task done         # Mark as DONE
+vibora current-task cancel       # Mark as CANCELLED
+
+# Server management
+vibora up                        # Start server daemon
+vibora down                      # Stop server
+vibora status                    # Check server status
+
+# Task management
+vibora tasks list                # List all tasks
+vibora tasks get <id>            # Get task by ID
+
+# Git operations
+vibora git status                # Git status for current worktree
+vibora git diff                  # Git diff for current worktree
+```
+
+### Options
+
+```bash
+--port=<port>   # Server port (default: 3333)
+--pretty        # Pretty-print JSON output
+```
+
+### Per-Worktree Development
+
+To run an isolated Vibora instance in a worktree:
+
+```bash
+# Create .env with a different port
+echo "PORT=3223" > .env
+
+# Create local .vibora directory for isolated database
+mkdir -p .vibora
+
+# Run dev servers (VITE_BACKEND_PORT is set automatically from PORT)
+mise run dev
+```
+
+## License
+
+[PolyForm Shield 1.0.0](LICENSE)