Use REPL interactive mode

Prerequisites

• You have completed the steps in Install and configure IaC Code.

• You are in the project directory that stores IaC files and session context.

• To query or manage cloud resources, you have configured an Alibaba Cloud identity with the required permissions.

Quick start

Start the REPL in the project directory:

cd /path/to/project
iac-code

The first time you use IaC Code, or when you need to change authentication information, enter:

/auth

Then submit the following request:

Plan an environment in Hangzhou that contains a VPC, two vSwitches, and two ECS instances. Query the available instance types, generate and validate a ROS template, and estimate the cost. Show the resources to be created and the cost, then wait for my confirmation. Do not deploy directly.

IaC Code analyzes the request, queries cloud services and inventory, generates and validates the IaC, estimates the cost, and then waits for your confirmation. Check the region, resource count, security groups, billing method, and cost before you decide whether to deploy.

After the deployment is complete, you can continue in the same session:

Query the stack that was just created and the status of the resources in it. Summarize any anomalies and next-step recommendations. Do not perform any changes.

Expected result: IaC Code retains the stack context from the preceding conversation, queries the deployment status, and provides recommendations. You can then submit requests to update, continue creating, or delete resources. Before a write operation runs, check the scope of impact again and confirm it.

Use conversations and tools

• Describe your cloud resource goals, regions, specifications, security and cost requirements directly. No need to write a complete template in advance.

• When IaC Code needs to read or write files, query cloud API operations, or manage stacks, it displays the corresponding tool call.

• According to the permission mode, operations such as writing files, deploying, updating, and deleting may require confirmation. Before you approve an operation, check the tool name, parameters, region, and target resources.

• Enter commands such as !git status --short to run local commands through the permission-controlled Bash tool.

• If the terminal supports it, press Shift+Enter to enter multiple lines. If the terminal does not recognize this composite key, press Esc and then press Enter.

Use slash commands

Enter / to view the slash commands that are currently available. Common entries include:

The complete command set evolves with each version. Use the / completion results in the REPL and the GitHub command reference as the authoritative sources.

Resume a session

Exiting the REPL does not delete the session. Choose a method based on which session you want to resume:

• Resume a specific session — Run iac-code --resume <session ID or name>.

• Continue the most recent session — Run iac-code --continue.

• Select a session interactively — Start the REPL, and then enter /resume.

  The REPL and the Web version share the same session storage, so you can also resume a session created in the Web version in the terminal.

FAQ

References

• Install and use IaC Code

• Full reference for the REPL interactive mode

• Slash commands

• Session management

• Full reference for Skills