release: v0.3.3

[code-crusher]

Cut from release/v0.3.2 (8ee6605) — same as the previous v0.3.3 attempt that was reverted. This PR retargets the same set of changes onto a fresh release branch so they can flow through the normal release/v* → main merge path.

What's in v0.3.3

Added

• /link slash command. Point this repo at other repos on your machine (absolute, ~/path, or relative). Links persist in .orb/links.json and are injected into the agent's environment details, including each linked repo's AGENTS.md pulled in ahead of time. .orb/links.json is shared with the Orbital IDE extension — links written there are honored here, and vice versa. A linked repo's AGENTS.md is read from .orb/, .orbital/, or .orbcode/.

Changed

• /init now writes to .orb/AGENTS.md and targets cold-start. The generated AGENTS.md lives in the repo-level .orb/ directory and now captures project structure, architecture, business-logic mapping, and code patterns/conventions — the context an agent needs to start coding without re-exploring.
• Repo-level agent data lives in .orb/. The folder OrbCode creates in a project for AGENTS.md (and now links.json) is .orb/ — a single, tool-neutral name shared by the IDE and the CLI. Machine settings are unchanged (~/.orbcode and <repo>/.orbcode/settings.json stay put); the legacy .orbcode/AGENTS.md location is still read for backward compatibility.
• Tweak CLI logo spacing.

Notes for reviewer

• Typecheck passes (npm run typecheck).
• .gitignore now excludes .orb/AGENTS.md and .orb/links.json — per-developer project memory and machine-specific absolute paths, respectively.
• src/memory/loader.ts keeps reading the legacy .orbcode/AGENTS.md for backward compat, so existing projects don't need to migrate.

[matterai-app]

Summary By MatterAI

🔄 What Changed

This release (v0.3.3) introduces a repository linking system and an automated codebase initialization command. Specifically, this update refines the /init command's prompt template in src/ui/App.tsx to ensure generated AGENTS.md files are concise (under 150 lines) and cover project tech stack, structure, and architecture. It also standardizes the .orb/ directory for shared agent data and adds the /link slash command for cross-repo context.

🔍 Impact of the Change

Engineers benefit from a more streamlined onboarding process where the AI agent generates high-density, low-token context files. This prevents "context bloat" in future prompts while providing the agent with essential architectural knowledge and cross-repository links, leading to more accurate code generation and better cross-service impact analysis.

📁 Total Files Changed

Click to Expand

File	ChangeLog
Prompt Refinement src/ui/App.tsx	Updated the /init command template to enforce a 150-line limit and specific structural requirements for AGENTS.md.
Ignore Rules .gitignore	Added exclusions for .orb/AGENTS.md and .orb/links.json to prevent committing local/machine-specific paths.
Version Bump package.json	Updated version to 0.3.3.
Logo Update src/branding.ts	Refreshed the ASCII logo for the CLI.
Link Logic src/config/links.ts	New core module for resolving, loading, saving, and rendering linked repository metadata.
Agent Context src/core/agent.ts	Integrated linked repository details into the system prompt's environment section.
Memory Loading src/memory/loader.ts	Updated memory loader to prioritize .orb/AGENTS.md and support legacy .orbcode paths.
UI Component src/ui/components/LinkManager.tsx	New interactive Ink component for managing repository links via the terminal.

🧪 Test Added/Recommended

Recommended

• Prompt Validation: Add a unit test to verify that the generated AGENTS.md content adheres to the 150-line constraint.
• Path Resolution: Validate resolveLinkTarget with various path formats (relative, absolute, and tilde-prefixed).
• UI Resilience: Ensure LinkManager correctly handles keyboard navigation and input truncation for long paths.

🔒 Security Vulnerabilities

No critical vulnerabilities detected. Path resolution is limited to the local filesystem, and sensitive link data is correctly excluded from version control via .gitignore.

[matterai-app]

✅ Reviewed the changes: Reviewed the v0.3.3 release PR adding the /link command, linked repos feature, .orb/AGENTS.md support, and updated branding. Code is well-structured with proper error handling, edge case coverage, and clean UI state management. No significant issues found.

[matterai-app]

✅ Reviewed the changes: Reviewed src/ui/App.tsx: no issues found. The single added line is instructional text within a prompt template string — no logic, security, or type-safety concerns.