Reports that re-run.

shell-report is a skill for AI coding agents. It serves HTML or Markdown reports locally, runs shell commands attached to the document, and can save the result as a static HTML snapshot.

$ node sr.mjs report.html
Interactive demo Example: report generated by an AI agent
ci-failure.html
Commit under review

This cell captures the commit SHA as sha so later cells can reuse it.

git rev-parse --short HEAD

        

      


      
CI run for that commit

      
This command uses {{sha}} from the previous cell to look up the failing run.

      

        

        

          
gh run list --commit {{sha}} --limit 1

          

        

      


      
TypeScript errors

      
The failing run points to the type-check step.

      

        

        

          
pnpm tsc --noEmit 2>&1 | tail -6

          

        

      


      
What changed in tsconfig

      
The same commit SHA is reused here to inspect the relevant config.

      

        

        

          
git show {{sha}}:tsconfig.base.json | grep -A2 '"strict"'

          

        

      


    

  

  










  
How it works

  

    

      
01

      
Write

      
Add data-cmd to an HTML element. Use the rest of the document for whatever text and structure you need.

    

    

      
02

      
Run

      
Start the server with node sr.mjs. Commands run in your shell with your current environment and $PATH.

    

    

      
03

      
Share

      
Use Save snapshot to export the current report as a static HTML file that can be opened without the server.

    

  










  
Install as a skill

  
Install the skill into your agent's skills directory to make it available across projects.

  

    

      
Claude Code

      

        
git clone https://github.com/callumalpass/shell-report \
  ~/.claude/skills/shell-report

        
      

    

    

      
OpenAI Codex

      

        
git clone https://github.com/callumalpass/shell-report \
  ~/.codex/skills/shell-report