signaloid-cli repos connect

Connect a new GitHub repository to Signaloid.

Synopsis

signaloid-cli repos connect --url <gitUrl> [options]

Options

Option	Required	Description	Default
--url <gitUrl>	Yes	Remote Git repository URL	-
--commit <sha>	No	Git commit hash or ref	HEAD
--branch <name>	No	Git branch name	main
--dir <path>	No	Build directory path	src
--args <args>	No	Default runtime arguments	""
--core-id <coreId>	No	Signaloid Core ID	-

Description

Connects a GitHub repository to your Signaloid account, allowing you to create builds from the repository's code. You can specify the branch, commit, build directory, and other configuration options during connection. The --args value sets the runtime arguments that are passed to your program as command-line arguments when it runs, not compiler flags. The repository must be accessible to your Signaloid account.

Examples

Connect a repository with defaults:

signaloid-cli repos connect \
  --url https://github.com/signaloid/Signaloid-Demo-C-Template

Connect with custom settings:

signaloid-cli repos connect \
  --url https://github.com/user/project \
  --branch develop \
  --dir src/main \
  --args "--enable-uncertainty" \
  --core-id cor_e7eec4dce06f5a03a1b5418e0c5cbd7e # C0Pro-S+

Connect a specific commit:

signaloid-cli repos connect \
  --url https://github.com/user/project \
  --commit a1b2c3d4e5f6

Notes

• The repository must be accessible to your Signaloid account
• For private repositories, ensure your GitHub account is connected to Signaloid
• URL validation is performed before attempting to connect
• Invalid URLs will be rejected with a clear error message

Troubleshooting

"Invalid repository URL" Error

Problem: Repository connection fails with invalid URL error.

Solutions:

1. Ensure URL is properly formatted: https://github.com/user/repo
2. Check for typos in the URL
3. Verify the repository exists and is accessible
4. Don't include .git suffix (it's optional)

"Repository not accessible" Error

Problem: Can't access private repository.

Solutions:

1. Connect your GitHub account to Signaloid
2. Verify you have access to the repository on GitHub
3. Check if the repository is private and permissions are correct
4. Re-authorize Signaloid's GitHub integration

"Build directory not found" Error

Problem: Specified build directory doesn't exist in repository.

Solutions:

1. Verify the directory path is correct
2. Check the default branch has the directory
3. Use --dir flag to specify correct path
4. List repository contents on GitHub to confirm structure

See Also

• signaloid-cli repos update - Update repository settings
• signaloid-cli repos disconnect - Disconnect a connected repository
• signaloid-cli repos list - List all connected repositories
• signaloid-cli repos - Repository management overview