dlw-machine-setup
v0.9.3
Published
One-shot installer for The Machine toolchain
Readme
dlw-machine-setup
NPM wrapper for the One-Shot Setup installer. This package runs a CLI wizard that configures AI-enhanced development with SAP-specific context files and MCP servers.
Usage
npx dlw-machine-setup@latest # install (interactive wizard)
npx dlw-machine-setup@latest uninstall # remove a previous install
npx dlw-machine-setup@latest --help # show subcommandsRequires Node.js >=18. No additional runtime or binaries needed.
Uninstall
The installer records every change it makes into .one-shot-state.json (a per-project rollback journal). Running npx dlw-machine-setup@latest uninstall from the project directory replays that journal in reverse:
- Files we created (e.g.
_ai-context/,factory/, hook scripts under.claude/hooks/) are deleted. - Files we modified (e.g. your
CLAUDE.md,.gitignore,.mcp.json,.claude/settings.json) have only our marker blocks or owner-tagged entries stripped — user content is preserved. - Globally-registered MCP servers (
claude mcp add) are removed viaclaude mcp remove. - The state file itself is deleted last.
The uninstaller shows a preview and asks for confirmation before making any changes.
What It Does
The wizard guides you through:
- GitHub authentication — one-time OAuth Device Flow (token cached for future runs)
- Persona selection — choose your SAP development domains (SAPUI5, CAP, ABAP, BTP, SAP DM, Forms)
- AI tool selection — Claude Code, GitHub Copilot, or Cursor
- Azure DevOps org — optional, for Azure DevOps MCP integration
- Project directory — where to install (defaults to current directory)
After confirming a preview, it downloads context archives from GitHub Releases and writes the appropriate config files for your AI tool.
Authentication
On first run, the installer prompts you to authenticate via GitHub OAuth Device Flow (browser-based). Your token is cached at ~/.one-shot-installer/github-token.json for all future runs.
Alternatively, set the GITHUB_TOKEN environment variable:
# macOS/Linux
GITHUB_TOKEN="your_token_here" npx dlw-machine-setup@latest
# Windows (PowerShell)
$env:GITHUB_TOKEN="your_token_here"
npx dlw-machine-setup@latestTroubleshooting
| Problem | Solution |
|---|---|
| Authentication fails | Delete ~/.one-shot-installer/github-token.json and re-run |
| Context downloads fail | Check network connectivity and GitHub access |
| SSO error | Ask your org admin to approve the OAuth app in GitHub org settings |
| Stale cached version | Always use npx dlw-machine-setup@latest to bypass npx cache |
License
Internal use only — DLW-INT-SAP-DEV organization
