feat: add Avian coding assistant support by avianion · Pull Request #772 · Fission-AI/OpenSpec

avianion · 2026-02-27T04:44:48Z

Summary

Add Avian as a supported AI coding tool in OpenSpec
Avian uses .avian/ config directory with nested commands/opsx/<id>.md command paths and YAML frontmatter (name, description, category, tags)
Follows the same adapter pattern as Claude Code and Crush

Changes

src/core/config.ts — add Avian to AI_TOOLS array (skillsDir: .avian)
src/core/command-generation/adapters/avian.ts — new command adapter
src/core/command-generation/adapters/index.ts — export adapter
src/core/command-generation/registry.ts — register adapter
docs/supported-tools.md — add Avian to tool directory table and available tool IDs
test/core/command-generation/adapters.test.ts — 5 new tests for adapter (all passing)

Test plan

pnpm run build compiles successfully
pnpm test — all 87 adapter tests pass (5 new Avian tests included)
Registry test passes (Avian adapter registered)
available-tools.test.ts passes
Init test passes with Avian in tool list

cc @TabishB

Summary by CodeRabbit

New Features
- Avian tool is now available in the product, enabling use of Avian alongside existing AI tools.
Documentation
- Added Avian to the Tool Directory Reference and the available tool IDs lists.
Tests
- Added tests covering Avian’s command formatting and path handling to ensure consistent behavior.

coderabbitai · 2026-02-27T04:45:09Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 3210f52e-758b-46b8-a2b3-fef93f962348

📥 Commits

Reviewing files that changed from the base of the PR and between b899e0a and 86e1e7a.

📒 Files selected for processing (5)

docs/supported-tools.md
src/core/command-generation/adapters/index.ts
src/core/command-generation/registry.ts
src/core/config.ts
test/core/command-generation/adapters.test.ts

✅ Files skipped from review due to trivial changes (3)

src/core/command-generation/adapters/index.ts
src/core/config.ts
docs/supported-tools.md

🚧 Files skipped from review as they are similar to previous changes (1)

test/core/command-generation/adapters.test.ts

📝 Walkthrough

Walkthrough

Adds an Avian ToolCommandAdapter and wires it into the adapters barrel and CommandAdapterRegistry, registers Avian in AI_TOOLS, updates docs, and adds adapter tests.

Changes

Avian adapter integration

Layer / File(s)	Summary
Adapter Implementation `src/core/command-generation/adapters/avian.ts`	New `avianAdapter` exported as `ToolCommandAdapter` with `toolId: 'avian'`, `getFilePath(commandId)` → `.avian/commands/opsx/<commandId>.md`, and `formatFile(content)` → YAML frontmatter (`name`, `description`, `category`, `tags`) followed by body.
Adapter Barrel Export `src/core/command-generation/adapters/index.ts`	Re-exports `avianAdapter` from `./avian.js`.
Registry Registration `src/core/command-generation/registry.ts`	Imports and registers `avianAdapter` in `CommandAdapterRegistry` static initializer.
Configuration `src/core/config.ts`	Adds `Avian` entry to `AI_TOOLS`: `{ name: 'Avian', value: 'avian', available: true, successLabel: 'Avian', skillsDir: '.avian' }`.
Documentation `docs/supported-tools.md`	Adds `avian` to Tool Directory Reference and to the “Available tool IDs (`--tools`)” list.
Tests `test/core/command-generation/adapters.test.ts`	Adds `describe('avianAdapter')` tests for `toolId`, `getFilePath` (including opsx path), `formatFile` YAML frontmatter and empty-tags behavior; includes `avianAdapter` in the path.join validation list.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant CommandGen as Command Generator
    participant Registry as CommandAdapterRegistry
    participant AvianAdapter as Avian Adapter
    participant FileSystem as File System

    User->>CommandGen: Request command generation for 'avian'
    CommandGen->>Registry: Lookup adapter for 'avian'
    Registry-->>CommandGen: Return avianAdapter
    CommandGen->>AvianAdapter: getFilePath(commandId)
    AvianAdapter-->>CommandGen: ".avian/commands/opsx/<commandId>.md"
    CommandGen->>AvianAdapter: formatFile(content)
    AvianAdapter-->>CommandGen: Formatted markdown with YAML frontmatter
    CommandGen->>FileSystem: Write formatted content to file path
    FileSystem-->>User: Command file created

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Fission-AI/OpenSpec#556: Adds and wires an avianAdapter and related registry/config/docs/tests changes (same integration surface).
Fission-AI/OpenSpec#707: Adds another tool adapter with parallel adapter/barrel/registry/config/test updates.
Fission-AI/OpenSpec#853: Adds support for a new AI tool via adapter, registry, config, docs, and tests.

Suggested reviewers

TabishB

Poem

🐰 A feathered adapter hops on cue,
Through .avian paths it writes for you,
YAML frontmatter neat and bright,
Commands take flight in morning light,
The rabbit cheers — a tidy byte!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and accurately describes the main change: adding Avian as a supported AI coding tool to the system.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

Generate code and open pull requests
Plan features and break down work
Investigate incidents and troubleshoot customer tickets together
Automate recurring tasks and respond to alerts with triggers
Summarize progress and report instantly

Built for teams:

Shared memory across your entire org—no repeating context
Per-thread sandboxes to safely plan and execute work
Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

greptile-apps · 2026-02-27T04:48:26Z

Greptile Summary

Adds Avian as a supported AI coding tool following OpenSpec's adapter pattern, consistent with other tools like Crush and Claude Code.

New command adapter formats files with YAML frontmatter (name, description, category, tags) and uses nested .avian/commands/opsx/<id>.md path structure
Adapter registered in CommandAdapterRegistry alongside 24 other tool adapters
Tool configuration added to AI_TOOLS array with .avian skillsDir
5 comprehensive tests validate adapter behavior (toolId, file paths, frontmatter formatting, empty tags)
Documentation updated with Avian in tool reference table and available tool IDs list

Confidence Score: 5/5

This PR is safe to merge with no identified issues
Implementation perfectly follows established patterns (identical structure to crushAdapter), all changes are additive with no modifications to existing functionality, comprehensive test coverage validates behavior, and documentation is properly updated
No files require special attention

Important Files Changed

Filename	Overview
src/core/command-generation/adapters/avian.ts	New adapter implementation following established pattern, matches Crush adapter structure
src/core/command-generation/registry.ts	Imported and registered avianAdapter correctly in alphabetical order
src/core/config.ts	Added Avian tool configuration with correct metadata and skillsDir
test/core/command-generation/adapters.test.ts	Added 5 comprehensive tests for Avian adapter following existing test patterns

Class Diagram

%%{init: {'theme': 'neutral'}}%%
classDiagram
    class ToolCommandAdapter {
        <<interface>>
        +string toolId
        +getFilePath(commandId: string) string
        +formatFile(content: CommandContent) string
    }
    
    class CommandAdapterRegistry {
        -Map~string, ToolCommandAdapter~ adapters
        +register(adapter: ToolCommandAdapter) void
        +get(toolId: string) ToolCommandAdapter
        +getAll() ToolCommandAdapter[]
        +has(toolId: string) boolean
    }
    
    class avianAdapter {
        +toolId: "avian"
        +getFilePath(commandId)
        +formatFile(content)
    }
    
    class claudeAdapter {
        +toolId: "claude"
        +getFilePath(commandId)
        +formatFile(content)
    }
    
    class crushAdapter {
        +toolId: "crush"
        +getFilePath(commandId)
        +formatFile(content)
    }
    
    ToolCommandAdapter <|.. avianAdapter : implements
    ToolCommandAdapter <|.. claudeAdapter : implements
    ToolCommandAdapter <|.. crushAdapter : implements
    CommandAdapterRegistry o-- ToolCommandAdapter : registers
    avianAdapter --> CommandAdapterRegistry : registered in static block

_{Last reviewed commit: 952533d}

Add Avian as a supported AI coding tool with skill and command generation. Follows the same adapter pattern as Claude Code and Crush with nested opsx command directories and YAML frontmatter.

avianion · 2026-03-05T06:14:00Z

Friendly follow-up — this PR is still active and ready for review. Would appreciate a look when you get a chance! cc @TabishB

avianion · 2026-03-05T06:17:57Z

Friendly follow-up — this PR is still active and ready for review. All feedback has been addressed. Would appreciate a look when you get a chance! cc @TabishB

avianion · 2026-03-05T08:37:09Z

Hey @TabishB — friendly follow-up on this PR. Avian is an OpenAI-compatible inference provider that's already live and powering apps like ISEKAI ZERO. This is a lightweight integration (standard OpenAI-compatible endpoint) and we're happy to address any feedback or make adjustments. Would love to get this merged if you have a moment to review. Thanks!

avianion · 2026-05-07T10:47:49Z

Resolved merge conflicts with latest upstream main.

avianion requested a review from TabishB as a code owner February 27, 2026 04:44

feat: add Avian coding assistant support

b899e0a

Add Avian as a supported AI coding tool with skill and command generation. Follows the same adapter pattern as Claude Code and Crush with nested opsx command directories and YAML frontmatter.

avianion force-pushed the feat/add-avian-tool-support branch from 952533d to b899e0a Compare February 27, 2026 21:08

Resolve merge conflicts with upstream main

86e1e7a

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add Avian coding assistant support#772

feat: add Avian coding assistant support#772
avianion wants to merge 2 commits into
Fission-AI:mainfrom
avianion:feat/add-avian-tool-support

avianion commented Feb 27, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Feb 27, 2026 •

edited

Loading

Walkthrough

Changes

Sequence Diagram(s)

Estimated code review effort

Possibly related PRs

Suggested reviewers

Poem

Uh oh!

greptile-apps Bot commented Feb 27, 2026

Uh oh!

avianion commented Mar 5, 2026

Uh oh!

avianion commented Mar 5, 2026

Uh oh!

avianion commented Mar 5, 2026

Uh oh!

avianion commented May 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

avianion commented Feb 27, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Test plan

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Sequence Diagram(s)

Estimated code review effort

Possibly related PRs

Suggested reviewers

Poem

Uh oh!

greptile-apps Bot commented Feb 27, 2026

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Class Diagram

Uh oh!

avianion commented Mar 5, 2026

Uh oh!

avianion commented Mar 5, 2026

Uh oh!

avianion commented Mar 5, 2026

Uh oh!

avianion commented May 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

avianion commented Feb 27, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Feb 27, 2026 •

edited

Loading