anthropics/claude-code-action

Feature Request: Display syntax errors for .claude/setting.json and GitHub Actions workflows

Open

#242 opened on Jul 10, 2025

View on GitHub
 (0 comments) (0 reactions) (0 assignees)TypeScript (1,889 forks)auto 404
enhancementgood first issuep3

Repository metrics

Stars
 (7,889 stars)
PR merge metrics
 (Avg merge 18d 20h) (26 merged PRs in 30d)

Description

Description

Problem: When running Claude Code Action, syntax errors in configuration files are silently ignored. Users get no error messages, making it hard to debug issues.

Request: Please add syntax error detection and display for:

  1. .claude/setting.json
  2. GitHub Actions workflow syntax (especially in Claude Code Action specific fields)

Examples

GitHub Actions Workflow

Currently no error shown for:

allowed_tools: |
  - 'Bash(pnpm install)'
  - 'Bash(pnpm test)'
  - 'Bash(pnpm build)'
  - 'Bash(pnpm lint)'

Expected error message:

Error: Invalid syntax in 'allowed_tools'. Remove hyphens (-) when using pipe (|) notation.
Correct format:
allowed_tools: |
  'Bash(pnpm install)'
  'Bash(pnpm test)'

.claude/setting.json

Currently no error shown for invalid JSON syntax.

Expected: Clear error messages with line numbers for JSON syntax errors.

Benefits:

  • Faster debugging
  • Better developer experience
  • Prevents silent failures

Contributor guide

Research direction
Investigate the parsing of .claude/setting.json and GitHub Actions workflow files in the Claude Code Action repository. Identify where syntax validation is missing and propose adding error messages for common syntax errors, especially in YAML pipe notation and JSON formatting. Look at existing parsers used and how errors are reported.
Tech stack
typescript
Domain
developer experiencetooling
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GitJSONYAML
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70