{"id":39458651,"url":"https://github.com/ljacobsson/sfn-cli","last_synced_at":"2026-01-18T04:40:10.994Z","repository":{"id":40994128,"uuid":"497327156","full_name":"ljacobsson/sfn-cli","owner":"ljacobsson","description":"Command line interface for building and live syncing Amazon StepFunctions state machine definitions","archived":false,"fork":false,"pushed_at":"2023-12-05T21:28:38.000Z","size":3468,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-08-27T19:15:53.583Z","etag":null,"topics":["aws-tools","code-generation","console-shortcuts","step-functions"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ljacobsson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-28T13:33:49.000Z","updated_at":"2024-11-03T11:26:05.000Z","dependencies_parsed_at":"2024-05-07T07:45:43.357Z","dependency_job_id":"647e1d52-2ce9-4ec2-8fa5-6ecd7c01d3c2","html_url":"https://github.com/ljacobsson/sfn-cli","commit_stats":null,"previous_names":["mhlabs/sfn-cli"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/ljacobsson/sfn-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljacobsson%2Fsfn-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljacobsson%2Fsfn-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljacobsson%2Fsfn-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljacobsson%2Fsfn-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ljacobsson","download_url":"https://codeload.github.com/ljacobsson/sfn-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ljacobsson%2Fsfn-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28529924,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws-tools","code-generation","console-shortcuts","step-functions"],"created_at":"2026-01-18T04:40:10.433Z","updated_at":"2026-01-18T04:40:10.976Z","avatar_url":"https://github.com/ljacobsson.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sfn-cli\n\nCommand line interface for inspecting Amazon StepFunctions executions and building state machine definitions.\n\n## Installation\n`npm i -g @mhlabs/sfn-cli`\n\n## Usage\n```\nUsage: sfn [options] [command]\n\nOptions:\n  -v, --vers         output the current version\n  -h, --help         display help for command\n\nCommands:\n  build|b [options]  Creates, explores and extends a StepFunctions ASL definition\n  help [command]     display help for command\n```\n\n## Create / modify a state machine definition\n\nCommand: `$ sfn build --definition-file my-definition.yaml`\n\nIf the `my-definition.yaml` file doesn't exist, you will be prompted to create it. The tool will then create a skeleton of an ASL definition and guide you through creating the initial state.\n\n![demo](./images/demo.gif)\n\n## Browse and inspect state machines\n\nCommand: `$ sfn inspect`\n\n```\nOptions:\n  -n, --name-prefix [prefix]          Name prefix of state machine (optional) (default: \"\")\n  -s, --status-filter [statusFilter]  Execution status filter. One of RUNNING | SUCCEEDED | FAILED | TIMED_OUT | ABORTED (optional)\n  -p, --profile [profile]             AWS profile to use (default: \"default\")\n  --region [region]                   The AWS region to use. Falls back on AWS_REGION environment variable if not specified\n```\n\n![demo](./images/demo-inspect.gif)\n\n## Real time sync your local ASL with the cloud\n\nPrerequisites is that the state machine is already deployed and that the local ASL definition matches the one that's deployed. This command supports SAM's `DefinitionSubstitution`s and a key/value map between substitution keys and actual values will be compiled at start-up.\n\nCommand: `$ sfn sync`\n\n```\nUsage: sfn sync|s [options]\n\nSyncs a StepFunctions ASL file with the cloud\n\nOptions:\n  -s, --stack-name [stackName]        The name of the deployed stack (required)\n  -t, --template-file [templateFile]  Path to SAM template file (default: \"template.yaml\")\n  -p, --profile [profile]             AWS profile to use (default: \"default\")\n  --region [region]                   The AWS region to use. Falls back on AWS_REGION environment variable if not specified\n  -h, --help                          display help for command\n```\n\n![demo](./images/demo-inspect.gif)\n\n## Known issues\n* Boolean logic in Choice states is not yet implemented\n* By design, the tool will not guide you through adding ARNs and other parameters to SDK integrations. This is best done in a code editor.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fljacobsson%2Fsfn-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fljacobsson%2Fsfn-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fljacobsson%2Fsfn-cli/lists"}