DocsCLIco copy

co copy

Copy built-in tools, plugins, and prompt templates into your project so you can customize them, learn from them, or debug their behavior.

Download

Quick Start: co copy --list to see what's available, then co copy Gmail to drop a tool into your project.

Quick Start

Terminalbash

$# See what is available

$co copy --list

$# Copy a tool

$co copy Gmail

$# Copy a plugin

$co copy re_act

$# Copy a prompt template

$co copy coding_agent

Why Copy?

Built-in tools work great out of the box. But sometimes you need to:

Add features

Extend functionality for your specific use case.

Modify behavior

Change how a tool works without forking the whole package.

Learn

Study the implementation patterns of well-tested tools.

Debug

Trace issues by stepping into source you control.

Copying gives you full control over the source code.

Usage

List Available Items

code

bash

co copy --list

output

Available Items to Copy

┏━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┓

┃ Name ┃ Type ┃ Path ┃

┡━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━┩

│ gmail │ tool │ gmail.py │

│ memory │ tool │ memory.py │

│ shell │ tool │ shell.py │

│ ... │ │ │

│ re_act │ plugin │ re_act.py │

│ shell_approval │ plugin │ shell_approval.py │

│ coding_agent │ prompt │ coding_agent/ │

└────────────────────────┴────────┴───────────────────────────┘

Copy a Tool

code

bash

co copy Gmail

output

Creates ./tools/gmail.py in your project.

Copy a Plugin

code

bash

co copy re_act

output

Creates ./plugins/re_act.py in your project.

Copy a Prompt Template

code

bash

co copy coding_agent

output

prompts/coding_agent/

├── prompts/

│ ├── main.md # Core agent behavior

│ └── tools/ # Per-tool guidance

│ ├── shell.md

│ ├── read.md

│ ├── write.md

│ └── todo.md

├── assembler.py # Prompt assembly utility

└── README.md

Copy Multiple Items

Terminalbash

$co copy Gmail Shell memory re_act

Custom Destination

Terminalbash

$co copy Gmail --path ./my_tools/

Force Overwrite

Terminalbash

$co copy Gmail --force

Available Tools

Name	File	Description
ask_user	ask_user.py	Ask user for input during agent execution
bash	bash.py	Bash command execution (Unix/Mac)
diff_writer	diff_writer.py	File editing with diffs
get_emails	get_emails.py	Fetch emails from inbox
gmail	gmail.py	Gmail integration (OAuth, send/receive)
google_calendar	google_calendar.py	Google Calendar events
memory	memory.py	Persistent agent memory
microsoft_calendar	microsoft_calendar.py	Microsoft Calendar
outlook	outlook.py	Outlook/Microsoft email
send_email	send_email.py	Send emails
shell	shell.py	Shell command execution (cross-platform)
slash_command	slash_command.py	Custom command extension
terminal	terminal.py	Interactive terminal sessions
todo_list	todo_list.py	Task list management
web_fetch	web_fetch.py	Web scraping tool

Available Plugins

Name	File	Description
auto_compact	auto_compact.py	Auto-compress context when nearing limit
calendar_plugin	calendar_plugin.py	Google Calendar integration
eval	eval.py	Task completion evaluation
gmail_plugin	gmail_plugin.py	Gmail OAuth flow
image_result_formatter	image_result_formatter.py	Base64 image handling
prefer_write_tool	prefer_write_tool.py	Guide agent to prefer write tool over shell
re_act	re_act.py	ReAct prompting pattern
shell_approval	shell_approval.py	User confirmation for shell commands
skills	skills.py	Auto-discover and load skills (.co/skills/, .claude/skills/)
subagents	subagents.py	Sub-agent task delegation
system_reminder	system_reminder.py	Inject contextual reminders into tool results
ui_stream	ui_stream.py	Stream agent output to UI
ulw	ulw.py	Ultra Light Work — autonomous continuous execution

Plugins with Prompts

Some plugins include prompt files. These are automatically copied together:

code

bash

co copy system_reminder

output

./plugins/system_reminder.py

./prompts/system-reminders/

├── test-reminder.md

└── security-warning.md

After Copying

Update Your Imports

main.py
python
# Before (from package)
from connectonion import Gmail

# After (from your copy)
from tools.gmail import Gmail

Customize the Code

Now you have full control:

main.py
python
# tools/gmail.py — your copy, modify freely!

class Gmail:
    def send(self, to, subject, body):
        # Add your custom logic here
        self.log_to_my_system(to, subject)  # Your addition
        # ... rest of original code

Options

Option	Short	Description
--list	-l	List available tools and plugins
--path	-p	Custom destination path
--force	-f	Overwrite existing files

Examples

Customize Gmail Tool

code

bash

# Copy Gmail tool
co copy gmail

# Edit your copy at tools/gmail.py

main.py
python
# agent.py
from tools.gmail import Gmail  # Use your customized version

agent = Agent("emailer", tools=[Gmail()])

Create Custom Plugin

code

bash

# Copy re_act as a starting point
co copy re_act

# Modify plugins/re_act.py for your needs

Copy All Email Tools

Terminalbash

$co copy gmail outlook

Available TUI Components

Name	File	Description
chat	chat.py	Chat interface component
divider	divider.py	Visual divider component
dropdown	dropdown.py	Dropdown selector
footer	footer.py	Footer bar component
fuzzy	fuzzy.py	Fuzzy search component
input	input.py	Text input component
keys	keys.py	Key binding handler
pick	pick.py	Item picker component
providers	providers.py	Model provider selector
status_bar	status_bar.py	Status bar component

Available Prompts

Name	Directory	Description
coding_agent	coding_agent/	Modular prompt template for coding assistants
cc_prompt	cc_prompt/	Claude Code system prompt — 250 prompt pieces organized by category

Available Trust Policies

Name	File	Description
trust/open	open.md	Development — allow all requests
trust/careful	careful.md	Testing — whitelist + LLM for unknowns
trust/strict	strict.md	Production — whitelist only

co copy

Quick Start

Why Copy?

Add features

Modify behavior

Learn

Debug

Usage

List Available Items

Copy a Tool

Copy a Plugin

Copy a Prompt Template

Copy Multiple Items

Custom Destination

Force Overwrite

Available Tools

Available Plugins

Plugins with Prompts

After Copying

Update Your Imports

Customize the Code

Options

Examples

Customize Gmail Tool

Create Custom Plugin

Copy All Email Tools

Available TUI Components

Available Prompts

Available Trust Policies

Star us on GitHub