Prerequisites
Dev tools
VSCode is recommended for development. If nothing else, it has heaps of high quality extensions and atopile language support, plus it’s used internally - making it easier to configure for purpose. You should have at a minimum:- Cursor or VSCode
- Cursor / VSCode atopile extension (also works for Cursor)
Verbosity
You can increase the verbosity of atopile by using the-v, -vv or -vvv flags, for example ato -vv build
Flags are placed after the
ato command and before the command you want to run. For example, ato -vv build runs the build command with the verbose flag set to the highest level, while ato build -vv will not work.Debugging
You can start the command-line tool in debug mode by using the--debug flag, for example ato --debug build
This runs a debugpy server on port 5678 which you can connect to with the VSCode built-in debugger.
Connect debugger in VSCode
If you’re having trouble with syntax highlighting in the debugger, it might be because VSCode sets up a mapping between the remote and local file paths by default—remove it.