Shopify/roast

View on GitHub

Structured AI workflows made easy

Stars: 1.2k
Forks: 76
Open beginner issues: 0
Indexed issues: 34

Dominant language: Ruby
License: MIT
Last GitHub push: Aug 10, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

34 open issues indexed

Add OrcaRouter as an optional AI provider Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Shopify/roast#1043 · Opened Sep 2, 2026
Add config method to parse prose output into structured JSON via a lightweight model Open

Difficulty 5/5 Over a week Newbie friendliness 38/100

Shopify/roast#1011 · Opened Jun 29, 2026
Add validate_schema_with config method for structured JSON output Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 48/100

Shopify/roast#1010 · Opened Jun 29, 2026
Add workflow to keep track of new formatters Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 48/100

Shopify/roast#1009 · 1 comment · Opened Jun 29, 2026
Add workflow to validate and update docs & doc comments Open

enhancement

Shopify/roast#1008 · 2 comments · 1 assignee · Opened Jun 29, 2026
Add structured json output feature to Roast Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 48/100

Shopify/roast#1007 · Opened Jun 29, 2026
Implement per-tool formatters for Pi agents Open

enhancement

Shopify/roast#1004 · 1 assignee · Opened Jun 29, 2026
ToolResult#format_webfetch Open

enhancement

Shopify/roast#1003 · 1 assignee · Opened Jun 29, 2026
ToolUse#format_webfetch Open

enhancement

Shopify/roast#1002 · 1 assignee · Opened Jun 29, 2026
Link taskoutput's tool_result output to the actual task title Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

Shopify/roast#988 · Opened Jun 25, 2026
tool_result formatter implementations Open

Shopify/roast#919 · 1 assignee · Opened Jun 4, 2026
tool_use formatter implementations Open

Shopify/roast#918 · 1 assignee · Opened Jun 4, 2026
Replace case statement in Claude Message.from_hash with dynamic class resolution Open

enhancement

Shopify/roast#911 · 1 assignee · Opened Jun 2, 2026
Consolidate provider branches in Chat#ruby_llm_context Open

Difficulty 3/5 1-2 days Newbie friendliness 58/100

Shopify/roast#887 · 1 comment · Opened May 15, 2026
Refactor agent provider message handling Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Shopify/roast#880 · Opened May 14, 2026
Add per-tool formatters for Claude agent tool use and tool result output Open

enhancement

Shopify/roast#879 · 1 assignee · Opened May 14, 2026
Abbreviate nested cog prefixes Open

enhancement

Difficulty 3/5 1-2 days Newbie friendliness 55/100

Shopify/roast#878 · Opened May 14, 2026
Add more chat cog providers Open

enhancement good first issue

Shopify/roast#869 · 1 assignee · Opened May 7, 2026
Support caching of chat cogs Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 38/100

Shopify/roast#860 · 2 comments · Opened Apr 12, 2026
Generalize VCR testing infrastructure for user workflows Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

Shopify/roast#835 · Opened Mar 2, 2026
`error.rb` Open

Shopify/roast#705 · Opened Jan 26, 2026
`cog_input_context.rb` Open

Difficulty 5/5 Over a week Newbie friendliness 10/100

Shopify/roast#703 · Opened Jan 26, 2026
`config_context.rb` Open

Difficulty 4/5 3-5 days Newbie friendliness 15/100

Shopify/roast#699 · Opened Jan 26, 2026
Add tests for nil_assertions.rb Open

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

Shopify/roast#695 · Opened Jan 26, 2026
Improve unit test coverage for lib/roast/ classes Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

Shopify/roast#682 · Opened Jan 26, 2026
Migrate YAML workflow Examples to DSL Open

DSL

Difficulty 5/5 Over a week Newbie friendliness 35/100

Shopify/roast#570 · Opened Nov 14, 2025
Make it so you can set debugger breakpoints in workflow files Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

Shopify/roast#546 · Opened Nov 7, 2025
add tool use stats to agent stats Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 20/100

Shopify/roast#540 · Opened Nov 6, 2025
add a way to specify expected workflow params (cli args) and validate them Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 20/100

Shopify/roast#539 · Opened Nov 6, 2025
Format exceptions messages/traces to point to the problem in the workflow, not in Roast internals Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

Shopify/roast#457 · Opened Oct 17, 2025
Revise main README.md Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

Shopify/roast#399 · 2 reactions · Opened Sep 2, 2025
Be able to pass an IO for our logger to write to. Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

Shopify/roast#398 · Opened Sep 2, 2025
Token usage counts don't include agent calls Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 42/100

Shopify/roast#343 · Opened Aug 5, 2025
Noisy output when running tests :( Open

contributor-dx

Difficulty 4/5 3-5 days Newbie friendliness 30/100

Shopify/roast#297 · 1 comment · Opened Jun 24, 2025

Shopify/roast

Get new issues in your inbox